Hugo

如果你已经第三次教 AI 同样的事情，问题可能不在 AI，而在工作流本身。 一、那些反复出现的「低级错误」 和 AI 助手协作写博客一段时间后，我开始注意到一个规律：同样的 bug 会以不同的面貌反复出现。 第一次是 +++ 残留在 YAML frontmatter 之后，导致 Hugo 解析失败，文章虽然能访问但首页根本看不到它。第二次是配图位置放错——AI 把 ![featured] 放在了二级标题下面，而不是文章开头。第三次是日期设成了未来，Hugo 直接跳过不生成。 每次修复完，我都以为「这次总该记住了」。但下一次，类似的问题又以新的形式出现。 这不是 AI 变笨了。这是流程的脆弱性在反复暴露。 二、7 个反复踩坑的具体场景 1. Frontmatter 格式混乱：YAML 与 TOML 混用 Hugo 支持 YAML (---)、TOML (+++) 和 JSON 三种 frontmatter。但如果一个项目里大部分文章用 YAML，突然插入一篇 TOML，PaperMod 的列表逻辑可能会跳过它——不是报错，就是安静地不显示。 2. +++ 残留：最隐蔽的错误 把 TOML 转成 YAML 时，如果前面的 --- 忘记删掉，或者后面跟着一串 +++，Hugo 不会报错。文章能 build，URL 能访问，但首页和分类列表里永远找不到它。hugo list all 显示正常，但 index.html 的 post-entry 列表里没有。 ...