YAML 校验器
在浏览器中检查 YAML 语法。显示第一处错误的行号、列号和通俗易懂的原因,并给出文档数、键数和嵌套深度。
多一个或少一个空格,就可能让 Kubernetes 配置清单、GitHub Actions 工作流或 Docker Compose 文件无法使用,而读取它的工具给出的报错往往晦涩难懂。把 YAML 粘贴到这里,就能知道它能否被解析;如果不能,会看到准确的行号和列号、周围的几行以及通俗的解释。有效的文件会得到简短的概要:文档数、键数、列表项数和嵌套深度。
使用方法
- 把 YAML 粘贴到输入框中,输入时即会自动检查。
- 如果无效,请阅读位置和解释,并查看上下文行(^ 标出出错的位置)。
- 修正第一处错误后重新检查;后面的错误要等第一处消失后才会显示。
- 还可以显示规范化的 YAML 或 JSON,看看数据实际上是如何被读取的。
计算公式
有效 = 文本能被解析为一个或多个 YAML 文档(js-yaml loadAll)
检查范围是语法:缩进、引号、括号、锚点和别名、标签以及重复的键。不检查模式(schema),例如 Kubernetes 字段名拼写是否正确,因为这取决于读取该文件的程序。
示例
在示例 Deployment 中,containers 是一个只有一项的列表,这一项含有 name、image 和 ports 三个键。如果把 image: 多缩进一个空格,解析器会在那一行停下并报 bad indentation of a mapping entry:这个键不再与上面的 name: 对齐。把它放回同一列,结果就会恢复为 YAML 有效——1 个文档、15 个键、2 个列表项、嵌套深度 8。
常见问题
YAML 里可以用制表符吗?
不能用于缩进,规范明令禁止。制表符可以出现在值和注释中。请把编辑器设置为在 .yml 文件中插入空格。
为什么重复的键会报错?
YAML 要求映射的键唯一。有些解析器会悄悄保留最后一个值,从而掩盖真正的错误,所以本校验器会把它报告出来。
会按模式(schema)校验吗?
不会。它只检查文件是不是格式正确的 YAML。字段对 Kubernetes、Ansible 或 GitHub Actions 是否正确,需要由这些工具另行检查。
我的文件会被上传吗?
不会。解析在浏览器中完成,所以配置文件中的机密信息不会离开你的设备。
资料来源
最后更新:
包含这些输入的页面地址: https://kakao.mobile/zh/tools/yaml-validator/
引用此工具
kakaoCalc. (2026, November 8). YAML 校验器. https://kakao.mobile/zh/tools/yaml-validator/
“YAML 校验器.” kakaoCalc, 8 Nov. 2026, kakao.mobile/zh/tools/yaml-validator/.