JSON 驱动接口;YAML 驱动配置。同样的数据、两种性格——两者互转是运维和前端开发里的日常操作。
YAML 为什么存在
JSON 严格:每个引号、逗号、括号都算数。YAML 用严格换可读性——缩进表示结构、允许注释、引号可省略。
这就是 Docker Compose、Kubernetes、GitHub Actions 都用 YAML 的原因:人会频繁阅读和编辑配置文件,而 YAML 是为人的手设计的。
转换本身
两种格式表达同样的形状——对象、数组、字符串、数字。转换就是直译:
{ "name": "app", "port": 8080 }
变成:
name: app
port: 8080
本站的 JSON ↔ YAML 转换工具在浏览器里双向转换,无需上传。
需要注意的坑
- 数字还是字符串:YAML 把
8080解析为数字,"8080"才是字符串。配置要求字符串时务必加引号——“port: 8080” 和 ‘port: “8080”’ 的区别坑过很多人。 - YAML 的怪癖:
yes/no/on/off在某些 YAML 版本里会被解析成布尔值,未加引号的*会触发别名语法。拿不准就加引号。 - 缩进即语义:惯例是每级两个空格;制表符和空格混用会立刻解析失败。
转换完成后,如果转出的是 JSON,交给 JSON 格式化工具校验并美化——在编辑器里发现的配置错误,总好过在生产环境里发现。