You need to enable JavaScript to run this app. Eleventy中Nunjucks集合遍历模板转Pug后不可迭代报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Eleventy中Nunjucks集合遍历模板转Pug后不可迭代报错如何解决

问题原因

你遇到的报错是两个差异共同导致的:

  1. 模板引擎遍历语法的兼容性问题:低于3.0.0版本的Pug仅支持each xxx in xxx的遍历语法,你写的each email of collections.emails中的of关键字无法被正确识别,导致引擎读取到的遍历目标为undefined。
  2. 容错逻辑差异:Nunjucks的for循环在遍历目标为undefined/null时会静默跳过不报错,但Pug的each语法要求遍历目标必须是数组等合法可迭代对象,一旦目标不存在就会直接抛出not iterable错误。

修复后的Pug代码

ul
  // 先判断集合存在再执行遍历
  if collections.emails
    // 改用标准的in关键字做遍历
    each email in collections.emails
      // 属性绑定直接写变量即可,不需要#{ }插值
      li: a(href=email.url) #{email.data.subject}

额外验证项

如果修改语法后仍然报错,可按以下顺序排查:

  • 确认Eleventy配置中已正确安装启用@11ty/eleventy-plugin-pug插件
  • 确认你的emails集合定义代码没有拼写错误,且确实会返回数组类型的结果
  • 如果你在其他位置自定义了全局collections变量,确认没有覆盖Eleventy默认注入的集合对象

内容的提问来源于stack exchange,提问作者Aaron Benjamin

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 01:06:02