本文目录
什么是 YAML，以及为何要校验它
YAML 的全称是 YAML Ain't Markup Language，是一种对人类友好的数据序列化格式，被广泛用于配置文件、CI/CD 流水线、基础设施即代码和数据交换。它基于缩进的语法使其易于阅读，但也让它对肉眼难以察觉的空白字符错误极为敏感。
在部署之前校验 YAML 至关重要，因为哪怕只是一个位置错放的空格或一个错误的缩进层级，都可能导致配置被解析成与预期不同的样子，甚至完全无法解析。Kubernetes 清单、Docker Compose 栈或 GitHub Actions 工作流中一个损坏的 YAML 文件，就可能使服务瘫痪或阻塞部署。
YAML 校验器的工作原理
校验器会解析你的 YAML 输入，并以精确的行号和列号报告语法错误，让你能够立刻修复问题。
- 粘贴你的 YAML —— 输入或粘贴任意大小的 YAML 内容，校验器会在你的浏览器中即时解析它
- 查看错误详情 —— 如果 YAML 格式有误，校验器会高亮标出解析器失败的确切行列位置，并附上清晰的错误信息
- 校验结构 —— 除语法之外，校验器还会检查重复键、类型错误以及其他可能引发意外行为的结构性问题
- 格式化输出 —— 有效的 YAML 会被自动格式化为缩进一致的形式，你可以将干净的版本复制回自己的项目中
免费试用 —— 无需注册
打开 YAML 校验器 →常见的 YAML 错误及其修复方法
YAML 语法看似简单，但在现实的配置文件中，有几种错误模式会反复出现。
- 缩进错误 —— YAML 使用空格来表示嵌套，混用制表符与空格或使用不一致的缩进层级，是解析失败最常见的根源
- 未加引号的特殊字符 —— 含有冒号、井号或花括号的值必须加引号，以防解析器将它们当作 YAML 语法来解释
- 重复键 —— YAML 允许在同一层级出现重复键，但只会保留最后一个值，这会悄无声息地覆盖之前的值，从而引发难以查找的 Bug
常见问题
YAML 和 JSON 有什么区别？
YAML 是 JSON 的超集，也就是说每一份有效的 JSON 文档同时也是有效的 YAML。YAML 增加了注释、多行字符串、锚点以及基于缩进的嵌套等特性，使其更具可读性。JSON 更为严格，也被 API 更广泛地支持；而 YAML 则更适合注重可读性的配置文件。
我可以在 YAML 中用制表符来缩进吗？
不可以。YAML 规范明确禁止使用制表符进行缩进。你必须使用空格，且每个缩进层级的空格数在同一文档中必须保持一致。大多数编辑器都可以配置为在你按下 Tab 键时插入空格。
校验器支持多文档的 YAML 吗？
支持。YAML 文件可以包含由三连字符分隔符分开的多个文档。校验器会独立解析每个文档，并以相对于整个文件的正确行号报告错误。