在安企CMS的内容管理实践中，灵活性是提升效率和实现个性化展示的关键。有时，我们会遇到这样的需求：后端通过一个自定义字段返回了一串由特定符号分隔的文本，比如一篇产品介绍可能有多个相关关键词，后端存储时是“关键词1|关键词2|关键词3”这样的格式。如何在前端模板中将这串文本漂亮地拆分成一个个独立的关键词，并让它们方便地展示或进行遍历呢？这时，安企CMS强大的模板引擎中内置的split过滤器就能派上大用场了。

灵活内容运营的起点：后端自定义分隔符字符串

安企CMS允许用户自定义内容模型和字段，这为内容运营带来了极大的便利。你可能为文章模型添加了一个名为“推荐标签”的自定义字段，在后台录入时，为了将多个标签存储在一个字段中，并便于后续解析，你选择了用一个特殊字符（例如竖线|、逗号,或分号;）来分隔不同的标签。这样，在数据库中，这个字段的值可能就是“品牌故事|营销策略|用户体验”这样的形式。

这种存储方式简洁高效，但在前端展示时，我们通常不希望直接显示这种原始的字符串。我们可能需要将每个标签单独渲染成一个可点击的徽章，或者在列表页中独立展示。此时，直接对原始字符串进行操作就显得力不从心了。

split过滤器：字符串与数组的桥梁

split过滤器正是解决这一问题的利器。它的核心功能是将一个字符串按照你指定的分隔符切割成一个数组（或称列表）。一旦字符串被转换成数组，模板中强大的for循环就可以派上用场，让你轻松地遍历每一个元素，实现精细化的展示和处理。

要使用split过滤器，其基本语法非常直观：

{{ 原始字符串变量 | split:"分隔符" }}

例如，如果你的后端自定义字段archive.CustomKeywords返回的是"品牌故事|营销策略|用户体验"，你可以这样使用split：

{{ archive.CustomKeywords | split:"|" }}

这条语句的执行结果会是一个包含三个元素的数组：["品牌故事", "营销策略", "用户体验"]。

结合set标签与for循环：让数组活起来

仅仅将字符串转换成数组还不够，我们需要将这个结果存储起来，以便后续的遍历。安企CMS模板引擎中的set标签就非常适合完成这个任务。set标签允许你在模板中定义一个临时变量来存储数据。

将split过滤器与set标签结合，可以这样操作：

{% set keyword_array = archive.CustomKeywords | split:"|" %}

现在，keyword_array变量就包含了你拆分后的关键词数组。接下来，我们就可以使用for循环来遍历这个数组，并对每个关键词进行单独处理了。

一个完整的示例可能如下所示：

{# 假设 archive.CustomKeywords 的值为 "品牌故事|营销策略|用户体验" #}
{% set custom_keywords_string = archive.CustomKeywords %}

{# 使用 split 过滤器将字符串按 "|" 分隔符转换为数组 #}
{% set keyword_array = custom_keywords_string | split:"|" %}

{% if keyword_array %} {# 判断数组是否为空，避免空数组时渲染无意义的HTML #}
    <div class="tags-container">
        {% for keyword in keyword_array %} {# 遍历数组中的每一个关键词 #}
            {# 对每个关键词进行 trim 操作，去除可能存在的首尾空白字符 #}
            <a href="/search?q={{ keyword | trim }}" class="tag-item">
                {{ keyword | trim }}
            </a>
        {% endfor %}
    </div>
{% else %}
    <p>暂无相关标签。</p>
{% endif %}

在这个例子中，我们首先将自定义字段的内容赋值给custom_keywords_string，然后通过split:"|"将其拆分为keyword_array。接着，利用if标签判断数组是否为空，若不为空，则通过for循环遍历每个keyword。在遍历过程中，我们还额外使用了trim过滤器来去除每个关键词可能存在的首尾空白字符，确保显示效果的整洁，并将其包裹在<a>标签中，指向一个搜索页，这样每个关键词都变成了一个可点击的搜索链接。

使用split过滤器的一些注意事项

  1. 分隔符的精确匹配：split过滤器会严格按照你提供的分隔符进行切割。如果你的字符串是"关键词1, 关键词2"（逗号后带空格），而你只用split:","来分隔，那么你得到的数组元素将是["关键词1", " 关键词2"]，其中第二个元素会包含前导空格。为了避免这种情况，你需要确保分隔符参数与实际字符串中的分隔符完全一致，或者在遍历时对每个元素使用trim过滤器去除空白。例如，使用split:", "来处理带空格的逗号分隔符。

  2. 分隔符不存在的情况：如果原始字符串中不包含指定的分隔符，split过滤器会返回一个只包含原始字符串本身的单元素数组。这通常符合预期，因为你依然可以通过for循环来处理这个唯一的元素。

  3. 空分隔符的特殊行为：如果你将分隔符设置为空字符串（""），split过滤器会将原始字符串中的每个UTF8字符都拆分成一个独立的数组元素。例如，"安企CMS" | split:""会得到["安", "企", "C", "M", "S"]。如果你确实需要按字符拆分，这种用法会很方便。

  4. make_list替代方案：对于纯粹按单个字符拆分字符串的场景，安企CMS还提供了make_list过滤器，它能更简洁地实现这一目的，例如"你好世界" | make_list会得到["你", "好", "世", "界"]。

通过split过滤器，安企CMS的用户能够更灵活地处理后端返回的格式化字符串，将其转化为结构化的数据列表，进而实现更加丰富和动态的前端内容展示。这不仅提升了网站内容的交互性，也为SEO优化和用户体验带来了更多可能。

常见问题 (FAQ)

Q1：如果我的关键词之间用逗号（,）分隔，split过滤器还能用吗？

A1：当然可以。split过滤器支持任何字符串作为分隔符。如果你的关键词是用“逗号+空格”分隔的，只需要将分隔符参数改为", "即可，例如{% set keyword_array = archive.CustomKeywords | split:", " %}。重要的是分隔符要与你实际存储的字符串精确匹配。在遍历时，为了确保每个关键词不包含意外的空白，仍然建议对每个元素使用| trim过滤器。

Q2：split后得到的数组元素，如果我还想对它们进行链接跳转，应该怎么做？

A2：split过滤器只负责将字符串转换为数组。如果你希望每个关键词都能点击跳转，你需要手动构建链接。例如，你可以定义一个基础搜索URL（如`/