JSON YAML 格式互转

JSON 与 YAML 如何表达结构化数据

JSON 和 YAML 都能表示嵌套的数据，但书写方式不同。JSON 用花括号表示对象、方括号表示数组，字符串通常带引号；YAML 常用缩进表达层级，列表项以短横线开头。这里说的“对象”是由名称和值组成的字段集合，“数组”是按顺序排列的一组值；两种格式都能承载字符串、数字、布尔值、空值以及更深层的对象或数组。YAML 1.2 以兼容 JSON 为目标，同时提供了更丰富的序列化表达；JSON 的对象字段则没有规范层面的顺序语义。

转换的是数据结构，输出文字会重新排版

转换会先读取输入，再按另一种语法生成输出，因此空格、引号和换行不必与原文一致。比如 {"service":{"name":"api","active":true,"ports":[8080,8443]}} 可以转成带有 service、name、active 和 ports 层级的 YAML。格式选项提供 2 空格或 4 空格缩进；选择哪一种只改变层级的排版，不改变字段和值的关系。例如 false 与 "false" 分别表示布尔值和文本，转换后也应确认目标字段保留了预期类型。

选择输入格式并查看转换结果

1. 粘贴原始内容

   把完整的 JSON 或 YAML 文本放到输入区。可先载入示例，确认层级和字段后再换成自己的内容。

2. 切换方向并选缩进

   页面初始方向为 JSON 转 YAML。使用方向切换控件可改为 YAML 转 JSON；再选择 2 或 4 个空格作为输出缩进。

3. 检查、复制或下载

   输入发生变化后，另一侧会自动生成结果。若出现解析错误，先检查括号、逗号、冒号、引号及 YAML 缩进；结果确认无误后可复制，或下载转换后的文本文件。

转换时常见疑问

转换后需要复核哪些信息

YAML 可以包含注释、锚点、别名和显式类型标签等 JSON 没有对应写法的内容；转成 JSON 时，这些写法或展示信息可能无法原样保留。锚点展开后也可能变成重复的数据节点。反向转换同样会重新安排引号和标量写法。若输入是多文档 YAML、使用自定义标签、非字符串映射键或依赖特定解析器规则的配置，请先用目标环境读取输出，不要只凭文本看起来整齐就覆盖正式文件。

JSON 语法错误或 YAML 缩进层级不一致时，解析可能失败；修正输入后再转换。转换只负责格式表示，不验证业务字段、密钥名称、配置约束或部署结果。