YAML vs JSON：何时使用哪个（含示例）
YAML 与 JSON 的实战对比：语法、特性、性能以及各自的最佳使用场景。
YAML vs JSON：应该用哪个？
JSON（JavaScript Object Notation）和 YAML（YAML Ain't Markup Language）是两种最流行的数据序列化格式。JSON 是 Web API 的通用语言，YAML 则主导着 Kubernetes、GitHub Actions、Docker Compose 等工具的配置文件。两者都可读，都能表达相同类型的数据，几乎所有现代编程语言都能解析它们。
它们的差异体现在语法、特性和使用体验上。JSON 严格无歧义；YAML 宽容灵活，支持注释、多行字符串和引用。选择哪个，取决于使用者和场景。
常见使用场景
- API 用 JSON：公共 Web API 和消息载荷
- 配置用 YAML：Kubernetes 清单、CI/CD 流水线、无服务器配置
- 日志用 JSON：可观测性工具中的结构化日志
- 文档用 YAML：教程、README 和混合数据的内容文件
- 存储用 JSON：MongoDB、CouchDB 等 NoSQL 数据库
方法 1：使用 UtilBoxx 免费 YAML ↔ JSON 转换器（推荐）
我们的 YAML ↔ JSON 转换器 双向转换，带语法校验和分屏预览。步骤如下：
- 访问 utilboxx.com/zh/tools/dev/yamlJson
- 把 YAML 或 JSON 粘贴到左侧面板
- 右侧面板即时显示转换结果
- 用交换按钮切换方向
- 一键复制结果
这个方法的优势：
- 双向转换并校验
- 语法错误处高亮，附有用提示
- JSON 转 YAML 时保留注释
- 移动端友好，输入面板大
- 完全在浏览器中运行，数据不上传
方法 2：使用命令行工具
`yq` 工具（jq 的 YAML 包装器）广泛可用：
```bash # YAML 转 JSON yq -o=json eval 'file.yaml'
# JSON 转 YAML yq -P eval 'file.json' ```
一次性转换也可以用 Python：
```python import json, yaml data = yaml.safe_load(open("file.yaml")) print(json.dumps(data, indent=2)) ```
适合脚本和自动化。
方法 3：使用编辑器扩展
VS Code 等现代编辑器内置或通过扩展支持 YAML 与 JSON 互转。打开文件，切换语言模式，再使用"格式化文档"命令。如果已经在编辑器中工作，这是最快的方式。
常见问题
YAML 是 JSON 的超集吗？
从技术上讲，大多数 YAML 解析器可以读取 JSON，因为 JSON 是 YAML 1.2 的子集。但在实践中，两种格式的惯例不同，把 JSON 风格的括号塞到 YAML 里很别扭。按需选择合适的工具。
哪个性能更好？
在大多数语言中 JSON 解析更快，因为它的语法简单。YAML 解析器更复杂——需要处理缩进、多种语法风格以及锚点等特性。对于高吞吐服务，JSON 在速度上胜出。
YAML 能做 JSON 能做的一切吗？
可以。YAML 支持 JSON 所有的数据类型（数字、字符串、布尔、数组、对象），还支持注释、多行字符串、锚点、复杂键等扩展。JSON 则有意保持极简。
API 端应该用 YAML 吗？
避免。API 最好用 JSON，因为每个客户端都能稳定解析。YAML 适合人工编辑的配置文件，但用在机器间通信中就过度设计了。
结论
YAML 和 JSON 都各自擅长。最快地在浏览器内互转它们，可以把 UtilBoxx YAML ↔ JSON 转换器 一直开着。