#common-pitfalls

Astro 内容集合 4 大避坑指南 — 我在 2026-10-09 一天踩完 4 次，写给下一个自己

Astro 内容集合 4 大避坑：summary 长度（schema 强制 20-300 字符，超 290 直接 build 失败）、YAML 引号转义（js-yaml 对单引号+中文+嵌套双引号+markdown 粗体解析出错，改用 `|` literal block scalar 最稳）、tag 值（`/` 和 `=` 让 Astro tag 路由生成崩溃——空间 OK 因为 Astro URL-encode，但斜杠断 URL 解析）、image 路径（frontmatter `image:` 引用相对路径，文件不存在 build 仍过但页面 404）。