YAML 错误百科
直接回答
多数 YAML 故障来自缩进、缺冒号或类型强制转换。在本索引中匹配错误信息,修好结构后用 YAML 1.2 解析器重新校验。
如何使用
按错误信息打开对应英文 Q&A,修复后用 在线校验 复核。中文专题页后续会补充独立译文。
解析错误
完整列表
快速排查清单
- Tab 换成空格,缩进宽度统一。
- 映射键后必须有冒号;同行值前保留空格。
- 字符串中的冒号必要时加引号。
- 每改一处就重新校验,避免行号漂移。
按症状分类
- 解析失败:mapping values are not allowed / expected key — 先查缩进与冒号。
- 运行时类型不对:开关变成布尔、版本号变成数字 — 加引号并阅读 1.1/1.2 指南。
- 语言导入失败:Python 未安装 PyYAML、Go 依赖版本混乱 — 见语言专题与 Q&A。
- 生态拒绝:kubectl/ansible 报 schema 错 — 语法通过后用生态 dry-run。