2026-04-19 · 约 1 分钟阅读
配置用 JSON 还是 YAML？
YAML 对人更友好；JSON 对机器与生态更通用——按工具链选择。
JSON 语法严格、跨语言支持好、易机器生成，适合互操作性强的场景。
YAML 可读性更强并支持注释，但存在更多边缘情况，需要团队对解析器行为达成一致。
如何阅读本对比
二者可表达相同数据模型，差异主要在可读性、注释支持与踩坑点。
| 方案 | 数据处理 | 典型速度 | 适用场景 |
|---|---|---|---|
| JSON 配置 | 文本为主，易在流水线中校验与 diff | 解析快，错误信息往往更直观 | API 载荷、构建产物、强 schema 场景 |
| YAML 配置 | 文本为主；注意不同解析器对类型与特殊值的差异 | 小文件成本可忽略 | Kubernetes 清单、需要注释的人工维护配置 |
结论要点
- 若平台已标准化 YAML（如 Kubernetes），优先跟随平台而非另起炉灶。
- 若追求跨语言最大兼容性，默认 JSON 更稳；需要时在边界用 YAML ⇄ JSON 转换。