line by line

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. 第 1 步 · 粘贴 YAML
    或直接载入 .yml / .yaml 文件。
  2. 第 2 步 · 开始校验
    逐行扫描并列出问题。
  3. 第 3 步 · 按行修复
    按提示定位到具体行号修改。
  4. 第 4 步 · 再校验一次
    直到没有红色错误。

更新记录

  • v1.0 2026-11-16
  • 首个版本:Tab 检测、缩进跨度、重复键、yes/no 类型歧义、行尾空格、行号与修复建议

常见问题

能发现所有 YAML 语法错误吗?
不能。这是轻量静态规则,覆盖缩进、Tab、重复键与类型歧义等高频问题,不等价于完整解析器。
为什么建议 2 格缩进?
YAML 不强制具体格数,但同一层级必须一致。2 格是社区最常见写法,工具按此给提示。
重复键怎么判断?
按缩进层级划分作用域,只有同一父级下的同名键才报重复。
yes/no 一定会出错吗?
不一定。如果你确实想要布尔值就没事;想要字符串时必须加引号,否则 YAML 1.1 会转换。
支持中文键名吗?
支持,规则只关心缩进和冒号结构,不限制字符。
文件会上传吗?
不会,全部在浏览器本地扫描。

💬 留言板 0

全部留言需审核通过后展示
💬

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

✍️ 说点什么
0 / 500
图形验证码
👣 做完这一步,顺便看看
🧰 乱码修复 / 文本编码转换 在线乱码修复工具:上传乱码文本文件或粘贴乱码字符串,用 UT… → 💻 假装工作模拟器 老板走近工位的一瞬间,点一下就能从摸鱼切回正经工作界面。代码… → 🧰 IP / 子网掩码计算器 在线子网计算器:输入 IP 地址与掩码(CIDR 前缀或点分… → ⏰ 下班倒计时 打工人专属下班计算器:实时倒计时距离下班还有多久、进度环显示… →
全部工具 →