本文详解如何在 Twig 模板中正确实现数组按 object.category 分组，避免 merge 覆盖同名键导致数据丢失，提供可直接运行的健壮方案与关键注意事项。
本文详解如何在 twig 模板中正确实现数组按 `object.category` 分组，避免 `merge` 覆盖同名键导致数据丢失，提供可直接运行的健壮方案与关键注意事项。
在 Twig 中对数组按某个字段（如 object.category）进行分组时，常见的误区是直接使用 merge 构建关联数组：
{% set organised_cats = {} %}
{% for element in sourceElements %}
{% set organised_cats = organised_cats|merge({ (element.object.category): element }) %}
{% endfor %}
该写法看似简洁，但 merge 在处理关联数组时会以键为单位覆盖而非追加——当多个元素拥有相同 category（如 "Cat1"）时，后出现的元素会完全替换前一个，最终每个分类仅保留一项，造成数据丢失。
✅ 正确做法是：先确保目标分类键存在且为数组，再将当前元素 push 进该分类数组中。由于 Twig 原生不支持 array_push 或动态索引追加，需借助 merge 的“数组合并”特性，配合空数组初始化与结构化构建：
{% set grouped = {} %}
{% for item in sourceElements %}
{% set category = item.object.category %}
{# 若该分类尚未存在，初始化为空数组 #}
{% if not grouped[category] is defined %}
{% set grouped = grouped|merge({ (category): [] }) %}
{% endif %}
{# 将当前 item 追加到对应分类数组中 #}
{% set grouped = grouped|merge({
(category): grouped[category]|merge([item])
}) %}
{% endfor %}
{# 使用示例：遍历分组结果 #}
{% for category, items in grouped %}
<h3>{{ category }}</h3>
-
{% for item in items %}
- {{ item.object.name }} (type: {{ item.type }}) {% endfor %}
? 关键说明：
- grouped[category]|merge([item]) 是核心：[item] 构造单元素数组，merge 将其与原分类数组拼接，实现“追加”语义；
- 必须显式初始化 grouped[category] = []，否则 grouped[category]|merge(...) 会因 null 导致错误或意外行为；
- 此方案时间复杂度为 O(n²)（Twig 模板层限制），强烈建议优先在控制器/服务层完成分组逻辑（如 PHP 中用 array_reduce 或 foreach 构建嵌套数组），模板仅负责渲染。
⚠️ 注意事项：
- 避免在复杂循环中频繁调用 merge —— Twig 的 merge 是不可变操作，每次均创建新数组，大数据量下性能显著下降；
- 若 item.object.category 可能为 null、空字符串或非标量类型，需提前过滤或提供默认值（如 {% set category = item.object.category|default('uncategorized') %}）；
- Twig ≥ 3.0 支持 filter, reduce 等更函数式方法，但分组仍需手动实现；推荐结合 map 与 group_by（若使用 Twig Extensions）简化逻辑。
总结：Twig 模板内分组需绕过 merge 的键覆盖陷阱，采用“初始化 + 合并数组”两步法。但请牢记——数据结构重组属于业务逻辑，应尽可能移出模板。将清洗、分组、排序等操作交给 PHP 层，不仅提升性能与可维护性，更能保障模板专注职责：清晰、安全地呈现数据。
