Eleventy中Nunjucks集合遍历模板转Pug后不可迭代报错如何解决
问题原因
你遇到的报错是两个差异共同导致的:
- 模板引擎遍历语法的兼容性问题:低于3.0.0版本的Pug仅支持
each xxx in xxx的遍历语法,你写的each email of collections.emails中的of关键字无法被正确识别,导致引擎读取到的遍历目标为undefined。 - 容错逻辑差异: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
相关产品推荐
相关产品推荐

