YAML 格式化
YAML 校验、美化与 JSON 双向转换,中文不转义;写 K8s / CI 配置时改完顺手验证一遍。
>_ 使用指南 · GUIDE
粘贴 YAML,校验语法、美化缩进,并与 JSON 双向转换——写 K8s 清单、CI/CD 配置(GitHub Actions、GitLab CI)、Docker Compose 时,改完顺手验证一遍,缩进错误当场现形。中文值不转义,转换后保持可读。
YAML 最容易出错的点全在「看不见的字符」:缩进用了 Tab、冒号后没空格、多行字符串折行。本工具校验会指出出错行;JSON 转换也是排查利器——YAML 转 JSON 成功说明结构合法,失败则定位问题。本地解析,零上传。
>_ 常见问题 · FAQ
Q1 · YAML 和 YML 有什么区别?
没有区别,只是文件扩展名的历史习惯:.yml 更短、出现更早,.yaml 是官方推荐写法。两者指同一种格式,系统读哪个取决于配置里写的路径,与扩展名语义无关。
Q2 · YAML 缩进错误怎么排查?
规则只有三条但容易踩:① 只用空格不用 Tab(混用直接报错,编辑器设置「Tab 转 4 空格」);② 同层元素缩进必须对齐;③ 冒号、短横线后要有空格。本工具校验报错会定位行号——从报错行向上找第一个缩进不同的地方,九成问题在那。转 JSON 验证也是好办法:能转换成功就说明结构被正确理解了。
Q3 · K8s / CI 配置改完怎么快速验证合法性?
两步:先用本工具校验 YAML 语法本身(缩进、类型);再用目标系统的 schema 校验语义(如 kubectl apply --dry-run=client、各 CI 的 lint 工具)。语法对但字段拼错(repicas)YAML 不报错,只有第二步能抓住——两层检查缺一不可。
Q4 · YAML 里的多行字符串怎么写?
块标量语法:| 保留换行(适合 shell 脚本、证书),> 折叠成一行(适合长段落描述)。配合 - 修饰符控制结尾是否补换行(如 |- 去掉末尾换行)。写 Dockerfile 内联脚本、K8s ConfigMap 内容时最常用,写完用本工具验证解析结果是否符合预期。
Q5 · YAML 转 JSON 后中文变成了 \u 转义是坏事吗?
不是。JSON 规范允许非 ASCII 字符转义存储,\u4e2d\u6587 与「中文」完全等价,解析后是同一字符串。部分工具输出转义形态只是为了兼容性。本工具转换保持中文原样不转义,可读性更好;无论哪种形态,程序解析结果一致。