YAML 和 JSON 怎么互转？配置文件、缩进、数组和类型检查指南

YAML 和 JSON 都常见于配置文件、API、CI/CD、Docker、Kubernetes 和静态站点数据。JSON 更严格，YAML 更适合人工编辑，但也更容易因为缩进和类型推断出错。

如果只是快速转换，可以用 YAML JSON 转换器。这篇讲互转前后要检查什么。

YAML 和 JSON 的区别

JSON 使用大括号、引号和逗号，格式严格：

{
  "name": "demo",
  "enabled": true
}

YAML 更像配置文本：

name: demo
enabled: true

YAML 可读性更好，但缩进、冒号、短横线都很重要。少一个空格，就可能变成完全不同的结构。

缩进是 YAML 最大的坑

YAML 用缩进表达层级，不建议混用 Tab 和空格。

推荐：

• 统一使用空格。
• 同一层级缩进一致。
• 数组项用 - 开头。
• 嵌套对象先格式化再修改。

如果 YAML 转 JSON 后结构不对，第一件事就是看缩进。

布尔值和空值要小心

YAML 里有些值会被自动识别成布尔值或空值。例如：

enabled: true
empty: null

如果你希望它们是字符串，就应该加引号：

enabled: "true"
empty: "null"

配置文件里版本号、身份证、手机号、订单号也建议当字符串处理，避免被误判为数字。

转换后要校验结构

建议流程：

1. 先复制原始内容。
2. 用 YAML JSON 转换器 转换。
3. 检查数组和对象层级。
4. 检查布尔值、数字、空值是否符合预期。
5. 用 JSON 格式化 / 校验工具 再看一遍 JSON 结构。

不要只看“转换成功”，还要看语义是否正确。

常见场景

YAML 转 JSON 常用于：

• 把配置文件交给接口或脚本处理。
• 检查 CI 配置结构。
• 把人工编辑配置转成机器可读数据。

JSON 转 YAML 常用于：

• 让配置更容易人工维护。
• 写文档示例。
• 整理复杂嵌套对象。

总结

YAML 和 JSON 互转的关键是结构和类型。YAML 更方便人写，JSON 更方便程序校验；转换时重点检查缩进、数组、布尔值、空值和字符串。

需要快速处理时，可以用 YAML JSON 转换器，转换后再用 JSON 校验工具复核结构。