JSON 和 YAML 怎么选？配置文件格式的取舍

发布于 2026-08-20 09:00:00 · 0 阅读 · 标签：JSON,YAML,配置文件,开发者

JSON 严格通用适合 API 交互，YAML 简洁可注释适合配置文件。对比语法、陷阱与适用场景，帮你的项目选对数据格式。

一、定位差异

• JSON：为数据交换而生，语法严格、机器友好，是 HTTP API 的事实标准。
• YAML：为人类阅读而生，缩进表达层级、支持注释，是 K8s/CI 配置文件的主流。

一句话：程序之间传数据用 JSON，写给人看的配置用 YAML。

二、语法直观对比

同一段数据：

JSON：{"name": "aistool", "tags": ["json", "yaml"], "online": true}

YAML：

name: aistool
tags:
  - json
  - yaml
online: true

YAML 省掉引号和大括号，但依赖缩进——空格错了结构就错了。

三、YAML 的经典陷阱

• 挪威问题：no/No/false 会被解析成布尔假，国家代码、选项值莫名变 false（YAML 1.1 里 on/off/yes/no 都是布尔）。
• 版本号变数字：version: 1.10 解析成 1.1，必须加引号 "1.10"。
• tab 陷阱：YAML 只认空格缩进，编辑器插入 tab 直接报错。

规则：字符串值一律加引号，能避开 90% 的坑。

四、JSON 的局限

1. 不支持注释：写配置文件时很痛苦（JSON5/JSONC 是补救方案）。
2. 尾逗号报错：最后一项多一个逗号整个解析失败。
3. 数字精度：大整数（超过 2^53）在 JS 里会丢精度，ID 类字段建议存字符串。

在线体验

不用装任何环境，直接用本站JSON 格式化校验工具在线操作，数据都在浏览器本地处理，方便又安全。