JSON 与 YAML：你应该使用哪种格式？

JSON 和 YAML 是现代软件开发中最流行的两种数据序列化格式。虽然它们有相似之处，但各自具有独特的优势，使每种格式更适合特定的使用场景。了解这些差异将帮助你为下一个项目选择合适的格式。

什么是 JSON？

JSON（JavaScript 对象表示法）是一种源自 JavaScript 的轻量级数据交换格式。它使用简单的键值对和数组结构，便于人和机器阅读。JSON 已成为 REST API、Web 服务和系统间数据交换的事实标准。

JSON 的简洁性是其最大的优势。仅有六种数据类型（字符串、数字、布尔值、null、对象和数组），规范很小，解析速度快。每种主要编程语言都有成熟的 JSON 库可用。

什么是 YAML？

YAML（YAML 不是标记语言）是一种人性化的数据序列化标准，专为配置文件和数据共享而设计。它使用缩进来表示结构，而非花括号和方括号，使文件更整洁、更易读。YAML 支持锚点、别名、多行字符串和显式类型转换等高级功能。

YAML 已成为 Docker Compose、Kubernetes、CI/CD 管道和许多框架中配置的首选格式。其可读性使其非常适合人类频繁编写和编辑的文件。

关键差异一览

何时使用 JSON

• API 和 Web 服务：JSON 是 REST API 的通用标准。每个 API 框架都原生支持它，轻量级的负载使网络传输保持快速。
• 数据存储：像 MongoDB 这样的 NoSQL 数据库使用类似 JSON 的文档。JSON 在日志系统和事件流平台中也很常见。
• 性能关键型应用：JSON 解析速度明显快于 YAML 解析。当吞吐量很重要时，JSON 是明显的赢家。
• 浏览器环境：JSON 是 JavaScript 原生支持的。内置的 JSON.parse() 和 JSON.stringify() 方法使其成为前端应用的自然选择。
• 系统间通信：当不同系统需要交换数据时，JSON 的简洁性和普遍支持降低了集成复杂性。

何时使用 YAML

• 配置文件：YAML 的可读性和对注释的支持使其非常适合人类编写和维护的配置。Docker Compose、Kubernetes 和 CI/CD 工具都使用 YAML。
• 文档和数据录入：当非开发人员需要创建或编辑结构化数据时，YAML 简洁的语法比 JSON 的花括号和引号更易上手。
• 复杂嵌套结构：YAML 的锚点和别名让你可以引用和复用内容，减少大型配置文件中的重复。
• 多行内容：YAML 的块标量使嵌入多行文本、代码片段或模板变得容易，无需转义字符干扰内容。

在 JSON 和 YAML 之间转换

由于 YAML 是 JSON 的超集，任何有效的 JSON 也是有效的 YAML。从 JSON 转换为 YAML 很简单，但反向转换需要小心，因为 YAML 支持 JSON 不支持的功能，如注释和锚点。

将 YAML 转换为 JSON 时，注释会被去除，锚点会被解析，YAML 特有的类型会映射到其 JSON 等效项。这是一种有损转换，因此如果你需要 YAML 源文件，请务必保留它们。

常见陷阱

两种格式都有各自的陷阱，可能会让开发者踩坑：

• YAML 缩进错误：一个多余的空格可能会悄悄改变数据结构。始终使用空格而非制表符，并配置编辑器显示空白字符。
• YAML 隐式类型：YAML 可能会意外地解释值。字符串 "true" 会变成布尔值，"2026-05-18" 会变成日期对象。使用引号强制字符串类型。
• JSON 尾随逗号：JSON 不允许在对象或数组的最后一项后有尾随逗号。这是解析错误的常见来源。
• JSON 缺少注释：JSON 中缺少注释使其不适合需要内联文档的配置文件。