YAML 格式化与校验

统一 YAML 的缩进,校验语法并指出出错的行号;检查 Tab 缩进、重复的键,以及 yes、no、08、22:30 等在 YAML 1.1 中会被误识别的值。支持多文档,适合 Kubernetes、Docker Compose、GitHub Actions 等配置。

YAML 的常见陷阱

写法你以为YAML 1.1 解析为正确写法
country: NO字符串 "NO"(挪威)falsecountry: "NO"
enabled: on字符串trueenabled: true 或 "on"
port: 080808080无效的八进制,或字符串port: 8080
time: 22:30字符串 "22:30"1350(六十进制)time: "22:30"
version: 1.10"1.10"1.1(数字)version: "1.10"
zip: 012345"012345"5349(八进制)zip: "012345"
name: ~字符串 "~"nullname: "~"
  • 哪些工具用 YAML 1.1:PyYAML(Ansible、Home Assistant 等)、Go 的 gopkg.in/yaml.v2(旧版 Kubernetes 工具)、SnakeYAML(Spring Boot)仍按 1.1 处理 yes/no/on/off。新的解析器(js-yaml 4、ruamel.yaml、yaml.v3)按 1.2 只认 true/false。为了在所有工具中一致,这类值请加引号。
  • 不能用 Tab 缩进:YAML 只允许空格缩进,编辑器中把 Tab 设置为插入空格。
  • 同级缩进必须一致:缩进的空格数可以是 2 或 4,但同一层级必须相同;列表项的 - 与父键对齐或多缩进一级都合法,Kubernetes 文档常用对齐写法。
  • 重复的键:多数解析器会让后面的值覆盖前面的值而不报错,配置可能悄悄失效;本工具会报出重复键的位置。
  • 格式化会丢失注释:本工具基于解析后的数据重新输出,注释和原有的引号风格不会保留。只想检查问题时看右侧下方的提示即可,不必替换原文。

YAML 与 JSON、TOML 互转请用 TOML、YAML、JSON 互转,只转 JSON 请用 JSON 与 YAML 互转,Spring 的 properties 转 YAML 请用 Properties 转 YAML。

YAML 格式化与校验常见问题

YAML 格式化与校验怎么使用?

把 YAML 粘贴到左侧或打开文件,右侧显示统一缩进后的结果,下方列出语法错误和问题提示;可以选择缩进、列表风格、引号风格、按键名排序和展开锚点,点“转为 JSON 查看”可以检查解析后的数据。

YAML 能用 Tab 缩进吗?

不能,YAML 只允许用空格缩进。

为什么 NO 变成了 false?

在 YAML 1.1 中 yes、no、on、off 会被当作布尔值,要表示字符串请加引号。

格式化后注释没了怎么办?

格式化会丢失注释,只想检查问题时看提示即可,不必替换原文。

怎么检查 YAML 是否有重复的键?

粘贴后工具会列出重复键的行号。

YAML 格式化与校验的结果应怎样理解?

格式化基于解析后的数据,注释、空行和原有的引号风格不会保留;按 YAML 1.2 解析,YAML 1.1 的差异以提示形式给出;自定义标签(如 !Ref)不支持。

输入内容会保存或发给外部服务吗?

YAML 只在浏览器本地处理,不会上传。

没有结果或操作失败时先检查什么?

报缩进错误时检查同级的键是否对齐、是否混用了 Tab;值中含有冒号加空格或以特殊符号开头时要加引号。

相关工具

SQL 格式化 · CSS 格式化 · .editorconfig 生成器 · .env 文件检查与转换 · 全部开发工具