JSON vs XML vs YAML 深度对比：如何选择合适的数据格式？

在软件开发中，我们经常需要在 JSON、XML、YAML 之间做出选择：用哪种格式存储配置？API 响应用什么格式？数据库导入导出用什么格式最方便？本文从多个维度深度对比这三种格式，帮助你在实际工作中做出最合适的技术选型。

1. 同一数据的三种格式表示

让我们用一个表示"用户订单"的数据来直观感受三种格式的差异：

{
  "order": {
    "id": "ORD-001",
    "status": "paid",
    "amount": 299.00,
    "customer": {
      "name": "张三",
      "email": "zs@mail.com"
    },
    "items": [
      {
        "name": "键盘",
        "qty": 1,
        "price": 199
      },
      {
        "name": "鼠标",
        "qty": 1,
        "price": 100
      }
    ]
  }
}

<?xml version="1.0"
  encoding="UTF-8"?>
<order>
  <id>ORD-001</id>
  <status>paid</status>
  <amount>299.00</amount>
  <customer>
    <name>张三</name>
    <email>
      zs@mail.com
    </email>
  </customer>
  <items>
    <item>
      <name>键盘</name>
      <qty>1</qty>
      <price>199</price>
    </item>
    <item>
      <name>鼠标</name>
      <qty>1</qty>
      <price>100</price>
    </item>
  </items>
</order>

order:
  id: ORD-001
  status: paid
  amount: 299.00
  customer:
    name: 张三
    email: zs@mail.com
  items:
    - name: 键盘
      qty: 1
      price: 199
    - name: 鼠标
      qty: 1
      price: 100

从视觉上就能明显感受到：同样的数据，XML 最冗长，YAML 最简洁，JSON 居中。但格式选择不能只看字符数——让我们深入分析每种格式的真实特性。

2. JSON 深度分析

核心优势

• Web 标准事实地位：REST API 的绝对主流，几乎所有现代 Web 框架都有一流的 JSON 支持
• 解析性能最优：相比 XML 的 DOM 解析，JSON 的流式解析在速度和内存占用上都有明显优势
• 类型系统清晰：number/string/boolean/null/object/array 六种类型，语义明确，不像 XML 所有值都是字符串
• 浏览器原生支持：JSON.parse() 和 JSON.stringify() 在所有现代浏览器中原生可用，无需任何库

核心局限

• 不支持注释：这是 JSON 最广为诟病的缺陷，使其作为配置文件时体验较差
• 不支持多行字符串：长文本必须压缩在一行，可读性下降
• 无类型约束机制：JSON 本身没有 Schema，需要 JSON Schema 等额外工具来验证数据结构
• 大数字精度问题：受 JavaScript IEEE 754 浮点数限制，超过 2^53 的整数会丢失精度

3. XML 深度分析

XML 的独特能力

XML 并不只是"老旧的 JSON"——它有几个 JSON 无法替代的特性：

• 属性（Attribute）：可以同时有标签内容和属性，比 JSON 更丰富的表达能力。例如 <price currency="CNY">299</price>
• 命名空间（Namespace）：支持多个数据源的字段合并，不会冲突。企业级集成中非常重要
• XML Schema（XSD）：强类型的数据验证标准，支持类型约束、范围限制、必填字段等
• XPath 和 XSLT：成熟的数据查询和转换标准
• 注释支持：<!-- 这是注释 -->，JSON 不支持

XML 的问题

• 极度冗长：每个字段都要有开闭标签，同等数据量通常是 JSON 的 2-4 倍大小
• 解析复杂：DOM 解析内存占用大，SAX 解析编写繁琐
• 学习曲线：命名空间、DTD、XSD、XPath 等配套标准庞杂，上手成本高

4. YAML 深度分析

YAML 的设计哲学

YAML 的全称是 "YAML Ain't Markup Language"（YAML 不是标记语言），它的设计目标是"对人类最友好的数据序列化格式"。YAML 是 JSON 的超集——所有合法的 JSON 也是合法的 YAML。

YAML 的独特优势

• 原生支持注释：# 这是注释，这是 YAML 作为配置文件比 JSON 更受欢迎的核心原因
• 多行字符串：支持块标量（|）和折叠标量（>），可以优雅地表示多行文本
• 引用与锚点：用 & 定义锚点，用 * 引用，避免重复数据
• 类型推断：自动识别数字、布尔值、日期，无需加引号

# YAML 多行字符串示例
description: |
  这是一段
  多行文本
  会保留换行符

# YAML 引用/锚点示例
defaults: &defaults
  timeout: 30
  retries: 3

production:
  <<: *defaults    # 继承 defaults 的所有字段
  host: prod.example.com

staging:
  <<: *defaults
  host: staging.example.com

YAML 的陷阱

• 缩进敏感：用空格表示层级，Tab 和空格混用会报错，而且错误不直观
• 类型推断有意外：yes/no/on/off 会被解析为布尔值，1.0 会被解析为浮点数，某些国家的缩写也可能被误判
• 解析速度最慢：相比 JSON 和 XML，YAML 的解析速度明显更慢
• 安全问题：某些 YAML 解析器支持反序列化任意对象，存在安全风险（需要使用安全解析模式）

5. 多维度横向对比

6. 如何做出正确选择

选 JSON 的情况

• 构建 REST API 或 GraphQL API
• 前端与后端之间的数据传输
• 浏览器端的本地存储（localStorage）
• 数据库 JSON 字段（MySQL、PostgreSQL、MongoDB）
• 对接第三方 API（99% 的现代 API 都是 JSON）
• Node.js 项目中的 package.json 等配置

选 XML 的情况

• 企业级系统集成（SOAP WebService、EDI）
• 需要用 XPath 做复杂数据查询
• Office Open XML（Word、Excel 文件格式）
• Android 资源文件（layout.xml、strings.xml）
• Maven、Ant 等 Java 构建工具配置
• SVG 图形格式（基于 XML）

选 YAML 的情况

• DevOps 配置文件（Docker Compose、Kubernetes、GitHub Actions）
• 应用程序配置文件（需要注释的场景）
• Ansible Playbook
• Jekyll、Hugo 等静态网站生成器的配置
• OpenAPI/Swagger API 文档

7. 真实场景决策案例

案例1：设计一个电商系统

商品 API 响应 → JSON；部署配置（Docker/K8s）→ YAML；与银行对账系统对接 → XML（银行系统普遍使用 SOAP）；商品数据库中的附加属性字段 → JSON 列。

案例2：开源工具项目

项目依赖管理（package.json）→ JSON；CI/CD 流水线（.github/workflows）→ YAML；国际化语言包 → JSON（i18next 等工具的标准格式）；README 和文档配置 → YAML Front Matter。