GUIDE深度 · Deep dive

YAML 解析常见错误

YAML 对缩进和冒号非常敏感。最常见的失败是 tab 缩进、同级缩进不一致、值里冒号没加引号、列表项和父键缩进错位。

更新 2026-11-01 · 公式可核验

错误清单

只用空格,不用 tab。

同级 key 缩进完全一致。

值里有冒号/井号时加引号。

多文档用 --- 分隔,别混在一起。

类型陷阱

yes/no/on/off 可能被当布尔。

前导零/日期可能被当数字/日期。

常见问题

为什么缩进看起来一样却报错?

可能混了 tab 或全角空格;用编辑器显示空白。

怎么快速定位?

从报错行往上找最近的同级 key。

数据来源

相关计算器

YAML 转 JSON把常用 YAML(对象/数组/标量)转成 JSON;本地解析,不上传。

更多指南

YAML 常用子集阅读指南
KEEP READING

继续读

按顺序读,或跳到同主题的其他指南。

全部指南 →