YAML 语法校验报错在第几行、怎么改,直接告诉你
YAML 对缩进极其敏感:一个 Tab、一次多缩进两格、同名键写两遍,都可能让 docker-compose 起不来。这里逐行检查Tab 混用、缩进跨度、重复键、yes/no 类型歧义与行尾空格,每条问题都带行号和修复建议。点「填入示例」可看一份故意写错的样本。
行号定位Tab 检测缩进检查重复键类型歧义示例
① 粘贴或载入 YAML
检查结果
还没有检查粘贴 YAML 后点「开始校验」
本地静态规则检查,不上传文件;不等价于完整 YAML 解析器。
✅口径说明与常见误填
只用空格缩进;yes/no 加引号,避免被当成布尔。
- 为什么 Tab 是硬错误
- YAML 规范只允许空格缩进。Tab 在不同编辑器里显示宽度不同,解析结果也会变,因此一旦检测到就标红。
- 缩进该几格
- 没有强制必须 2 格,但同一层级必须一致。本工具按 2 格为基准提示,能覆盖绝大多数配置文件的写法。
- 重复键为什么危险
- 同名键出现两次时,不同解析器可能取第一个或最后一个,结果不可预测。工具按缩进层级划分作用域,只报真正同级的重复键。
- yes / no 的坑
- YAML 1.1 会把 yes、no、on、off 解析成布尔值。如果本意是字符串(如用户名 yes),需要加引号。
这个工具解决什么问题
YAML 语法校验针对最常见的配置事故:Tab 混用、缩进跳格、重复键、yes/no 类型歧义、行尾空格。工具逐行扫描并给出行号 + 问题 + 修复建议,点「填入示例」可以看到一份包含全部问题的样本。它是一套轻量静态规则,适合在提交 docker-compose、GitHub Actions、K8s 配置前快速自查,不上传文件、不依赖服务端解析器;复杂语法错误仍需用完整 YAML 解析器确认。
写 YAML 的三条经验
① 只用空格:编辑器里把 Tab 自动转空格打开,能省掉一半 YAML 报错。
② 层级统一 2 格:同一文件别混用 2 格和 4 格,最容易在深层嵌套出错。
③ 字符串加引号:yes/no/on/off 与数字外观的值,写字符串时一律加引号。
怎么用
-
第 1 步 · 粘贴 YAML或直接载入 .yml / .yaml 文件。
-
第 2 步 · 开始校验逐行扫描并列出问题。
-
第 3 步 · 按行修复按提示定位到具体行号修改。
-
第 4 步 · 再校验一次直到没有红色错误。
更新记录
-
v1.0
2026-11-16
- 首个版本:Tab 检测、缩进跨度、重复键、yes/no 类型歧义、行尾空格、行号与修复建议
常见问题
能发现所有 YAML 语法错误吗?
不能。这是轻量静态规则,覆盖缩进、Tab、重复键与类型歧义等高频问题,不等价于完整解析器。
为什么建议 2 格缩进?
YAML 不强制具体格数,但同一层级必须一致。2 格是社区最常见写法,工具按此给提示。
重复键怎么判断?
按缩进层级划分作用域,只有同一父级下的同名键才报重复。
yes/no 一定会出错吗?
不一定。如果你确实想要布尔值就没事;想要字符串时必须加引号,否则 YAML 1.1 会转换。
支持中文键名吗?
支持,规则只关心缩进和冒号结构,不限制字符。
文件会上传吗?
不会,全部在浏览器本地扫描。
💬 留言板 0
全部留言需审核通过后展示🎉
留言已提交!
现在只有你自己能看到这条留言(已标上「待审核」),管理员审核通过后才会展示给所有人~

还没有留言,来抢沙发吧!