在AnQiCMS模板开发过程中，我们经常会遇到需要对数据进行灵活处理的情况，其中一项常见需求就是将一个包含多个信息的长字符串，按照特定的分隔符（例如空格）拆分成独立的字符串数组，以便进行循环展示或进一步操作。AnQiCMS的模板引擎提供了简洁高效的过滤器（Filter）功能，能够轻松实现这一目标。

理解 split 过滤器

AnQiCMS模板系统采用的是类似Django的模板引擎语法，它内置了多种实用过滤器来帮助我们处理数据。对于字符串拆分的需求，split 过滤器是我们的得力助手。

split 过滤器的核心作用就是将一个字符串依据指定的分隔符，切割成一个字符串切片（在模板语境下，我们可以将其理解为字符串数组）。它的基本语法非常直观：{{ 变量 | split:"分隔符" }}。

当您使用 split 过滤器时，您需要提供两个关键信息：

  1. 待处理的字符串变量：这是您希望进行拆分的长字符串。
  2. 分隔符：一个用于指定字符串应该在哪里被切割的字符或字符串。例如，如果您的字符串是”标签1 标签2 标签3”，那么分隔符就是空格（" "）。

该过滤器处理后，会返回一个包含拆分后子字符串的数组。如果原始字符串中不包含指定的分隔符，split 过滤器会返回一个只包含原始字符串本身的单元素数组。此外，如果将空字符串作为分隔符（""），split 过滤器则会将原始字符串中的每一个字符都拆分成数组的一个元素。

实际操作：将长字符串按空格拆分成数组

假设您有一个文档字段 archive.Keywords，其内容是一个由空格分隔的关键词字符串，例如 "AnQiCMS 模板开发 字符串处理 Go语言"。现在，我们希望在页面上将这些关键词作为独立的标签逐一展示。

我们可以通过以下模板代码来实现：

{% set keywordString = "AnQiCMS 模板开发 字符串处理 Go语言" %}
{# 使用 split 过滤器将字符串按空格拆分成数组 #}
{% set keywordArray = keywordString|split:" " %}

<div>
    <h4>关键词列表：</h4>
    <ul>
        {# 打印数组的原始结构，方便调试理解 #}
        <p>数组原始结构：{{ keywordArray|stringformat:"%#v"|safe }}</p>

        {# 遍历拆分后的数组，逐一展示关键词 #}
        {% for keyword in keywordArray %}
            <li>{{ keyword }}</li>
        {% endfor %}
    </ul>
</div>

在这段代码中：

  1. 我们首先使用 {% set keywordString = "..." %} 模拟了一个长字符串变量 keywordString。在实际使用中，这通常是来自您的 archive.Keywords 或其他数据字段。
  2. 接着，关键一步是 {% set keywordArray = keywordString|split:" " %}。这里，keywordString 变量通过管道符号 | 传递给 split 过滤器，并指定了分隔符为 " "（一个空格）。split 过滤器执行后，会返回一个字符串数组，并赋值给 keywordArray 变量。
  3. 为了帮助您更好地理解 keywordArray 的内部结构，我们使用了 {{ keywordArray|stringformat:"%#v"|safe }}。stringformat:"%#v" 过滤器会以Go语言的详细结构打印变量，而 safe 过滤器则确保打印的字符串（如果包含特殊字符）不会被自动转义。
  4. 最后，我们使用 {% for keyword in keywordArray %} 循环遍历 keywordArray 中的每一个元素（也就是每一个关键词），并将其包裹在 <li> 标签中进行展示。

执行这段模板代码后，您将在页面上看到类似以下输出：

关键词列表：
数组原始结构：[]string{"AnQiCMS", "模板开发", "字符串处理", "Go语言"}
<ul>
    <li>AnQiCMS</li>
    <li>模板开发</li>
    <li>字符串处理</li>
    <li>Go语言</li>
</ul>

通过这种方式，您就可以灵活地将一个长字符串拆分成独立的数组元素，并在AnQiCMS模板中进行各种动态展示。

与 make_list 过滤器的对比

在AnQiCMS中，还有一个 make_list 过滤器，它也可以将字符串转换为数组。然而，make_list 的工作方式与 split 过滤器有所不同：make_list 是按字符来拆分字符串，而不是按指定的分隔符。

例如：

{% set myString = "你好 世界" %}
{% set charArray = myString|make_list %}
{% set spaceSplitArray = myString|split:" " %}

<p>按字符拆分：{{ charArray|join:"," }}</p>
<p>按空格拆分：{{ spaceSplitArray|join:"," }}</p>

输出将会是：

按字符拆分：你,好, ,世,界
按空格拆分：你好,世界

不难发现，make_list 将空格也视作一个字符进行了拆分，而 split:" " 则精确地以空格为界，保留了”你好”和”世界”这两个词。因此，当您需要按特定分隔符（如空格、逗号等）拆分词语时，split 过滤器是更合适的选择。

通过 split 过滤器，您可以灵活地处理各种字符串数据，为您的AnQiCMS网站带来更丰富的动态内容展示。

常见问题 (FAQ)

  1. 如何将拆分后的字符串数组重新拼接成长字符串？ 您可以使用 join 过滤器将数组元素重新拼接成一个字符串。例如，如果 keywordArray 是一个已拆分的数组，您想用逗号加空格将其拼接起来，可以这样做：

    {% set keywordArray = "AnQiCMS 模板开发 字符串处理"|split:" " %}
<p>重新拼接后的字符串：{{ keywordArray|join:", " }}</p>
{# 输出: 重新拼接后的字符串：AnQiCMS, 模板开发, 字符串处理 #}

  2. 如果我的长字符串不是按空格，而是按其他符号（如逗号）分隔的，该如何拆分？ split 过滤器非常灵活，您只需要将分隔符参数替换为您实际使用的符号即可。例如，如果字符串是 "关键词A,关键词B,关键词C"，那么分隔符就应该是逗号（,）：

    {% set commaSeparatedString = "关键词A,关键词B,关键词C" %}
{% set newArray = commaSeparatedString|split:"," %}
<p>按逗号拆分：{{ newArray|join:" / " }}</p>
{# 输出: 按逗号拆分：关键词A / 关键词B / 关键词C #}

  3. 拆分后，我只想获取数组中的某一个元素，而不是全部遍历，可以吗？ 当然可以。AnQiCMS模板支持数组的索引访问，索引从 0 开始。例如，要获取 keywordArray 的第一个元素（索引为 0），您可以这样做：

    {% set keywordArray = "AnQiCMS 模板开发 字符串处理"|split:" " %}
<p>第一个关键词：{{ keywordArray[0] }}</p>
{# 输出: 第一个关键词：AnQiCMS #}
{% if keywordArray|length > 1 %}
<p>第二个关键词：{{ keywordArray[1] }}</p>
{% endif %}

    在访问特定索引时，最好先判断数组长度，以避免索引越界错误。