ZH
我的工具

YAML 校验器

在浏览器中检查 YAML 语法。显示第一处错误的行号、列号和通俗易懂的原因,并给出文档数、键数和嵌套深度。

把同样的数据以统一的风格写回(不保留注释)。
我的工具 →
广告

多一个或少一个空格,就可能让 Kubernetes 配置清单、GitHub Actions 工作流或 Docker Compose 文件无法使用,而读取它的工具给出的报错往往晦涩难懂。把 YAML 粘贴到这里,就能知道它能否被解析;如果不能,会看到准确的行号和列号、周围的几行以及通俗的解释。有效的文件会得到简短的概要:文档数、键数、列表项数和嵌套深度。

使用方法

  1. 把 YAML 粘贴到输入框中,输入时即会自动检查。
  2. 如果无效,请阅读位置和解释,并查看上下文行(^ 标出出错的位置)。
  3. 修正第一处错误后重新检查;后面的错误要等第一处消失后才会显示。
  4. 还可以显示规范化的 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 是否正确,需要由这些工具另行检查。

我的文件会被上传吗?

不会。解析在浏览器中完成,所以配置文件中的机密信息不会离开你的设备。

资料来源

最后更新:

引用此工具
APA

kakaoCalc. (2026, November 8). YAML 校验器. https://kakao.mobile/zh/tools/yaml-validator/

MLA

“YAML 校验器.” kakaoCalc, 8 Nov. 2026, kakao.mobile/zh/tools/yaml-validator/.

广告