Twig中{% for %}的基本写法是{% for item in items %}...{% endfor %}，支持空数组/undefined自动跳过、键值对遍历、loop内置变量（如loop.index、loop.first）、数字范围（0..9）、条件过滤及嵌套循环，需确保数据源为数组或Traversable。
Twig 中 {% for %} 的基本写法
直接用 {% for item in items %}，不是 PHP 那套 foreach ($items as $item)。Twig 的语法更接近自然语言，但大小写和空格必须严格匹配。
常见错误是漏掉 endfor 或写成 endforeach（那是 PHP）；也有人把变量名写错，比如 {% for user in users %} 却传了 $data['users'] 而不是 $data['users'] —— Twig 里只认键名，不认 PHP 变量名。
{% for post in posts %}{{ post.title }}{% endfor %}- 如果
posts是空数组或null，循环自动跳过，不会报错 - 支持嵌套：
{% for user in users %}{% for post in user.posts %}...{% endfor %}{% endfor %}
怎么安全遍历可能为 null 或非数组的数据
Twig 默认对 null、false、未定义变量静默处理，但遇到字符串或整数时会报 Impossible to iterate a scalar value 错误 —— 这是最常卡住新手的地方。
别依赖模板层做类型判断，后端应确保传入的是数组或 Traversable。实在要兜底，用 default 过滤器：
-
{% for item in items|default([]) %}：强制转为空数组 -
{% for item in items ?? [] %}：等价写法，更简洁 - 避免
{% if items is defined %}{% for ... %}{% endif %}，多一层判断没实际意义
常用内置变量：loop.index、loop.first 怎么用
Twig 在 {% for %} 内自动提供 loop 对象，不用额外传参。注意命名全小写，loop.Index 或 loop.first() 都无效。
-
loop.index：从 1 开始的当前索引（第几个元素） -
loop.index0：从 0 开始，适合做数组下标或 CSS 类名 -
loop.first/loop.last：布尔值，判断是否首/末项 -
loop.length：总数量，但别在循环内反复用它做性能敏感操作
示例：{% for post in posts %}<div class="post {{ loop.first ? 'first' : '' }}">...</div>{% endfor %}
Symfony 场景下容易被忽略的点
在 Symfony 控制器中传数据给 Twig 时，别用 array_values() 强制重排索引 —— 如果原始数组是关联的（比如 ['a' => ..., 'b' => ...]），array_values() 会丢掉键名，但多数时候你并不需要它；反而可能破坏前端 JS 依赖的 key 绑定。
另外，Doctrine 查询结果默认是对象数组，{% for user in users %}{{ user.name }}{% endfor %} 没问题，但别试图在模板里调用 user.getName() —— Twig 默认只访问 public 属性或通过 getter（需启用 autoescape 和 property_accessor 配置），稳妥做法是控制器提前映射好字段。
真正麻烦的是分页场景：别在模板里写 {% for post in pagination.items %} 然后又手动算偏移量，直接用 KnpPaginatorBundle 提供的 pagination 对象和 pagination.items 即可 —— 它已经处理好了切片。
