如何把 JSON 转成 YAML

如何把 JSON 转成 YAML

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 格式化工具校验并美化——在编辑器里发现的配置错误,总好过在生产环境里发现。