JSON 与 YAML 互转:缩进、注释与字符串类型

趁手 · 更新于

JSON 与 YAML 互转用于改变数据的表示格式,不会自动验证 Kubernetes、Docker Compose 或 CI 配置是否符合它们的业务规范。

怎么选择转换方向?

  1. 打开转换工具,点击 JSON → YAML 或 YAML → JSON。
  2. 粘贴对应格式的输入,检查右侧输出。
  3. 复制到配置文件后,使用目标系统的校验工具确认语义。

方向由按钮选择,不是自动识别。

输入输出示例

JSON:

{"id":1,"name":"示例"}

对应 YAML:

id: 1
name: 示例

同一个数据对象可以用不同文本格式表示。缩进样式和引号不一定与原文相同。

注释为什么消失?

YAML 的注释不是数据,YAML 解析成对象后再输出 JSON 时不会保留注释。JSON 也没有注释语法,因此往返转换不能用来无损保存配置文件的排版和说明。

为什么看起来像数字的字符串要加引号?

例如配置里的字符串 "001",直接写成数字可能改变类型和含义。对有特殊含义的字符串应保留引号,并在转换后检查实际类型。YAML 缩进请使用空格,避免 Tab。

哪些情况需要额外检查?

YAML 多文档、自定义 tag、锚点以及无法直接表达为 JSON 的数据需要专门处理;本工具不保证原文本无损往返。处理大整数时还要注意浏览器 JavaScript 数字精度限制。

工具的 YAML → JSON 使用 js-yaml;参考 js-yaml 文档与YAML 1.2.2 规范。

打开对应工具

继续阅读