对比
JSON vs TOML
JSON 广泛用于 API 和程序间数据交换。TOML 面向人工维护的应用配置，提供易读的键值、表格和数组结构。
应该选择哪种格式？
API 或工具要求 JSON 时使用 JSON。人工维护的配置若需要注释和清晰表格，可考虑 TOML，并先确认解析器及版本支持。
适用于 JSON
Web API、配置文件和数据交换
- 传递结构化数据
适用于 TOML
应用程序和工具配置
- 带结构化值的可读设置
基本信息
| 项目 | JSON | TOML |
|---|---|---|
| 扩展名 | .json | .toml |
| MIME 类型 | application/json | application/toml |
| 常见用途 | Web API、配置文件和数据交换 | 应用程序和工具配置 |
| 打开方式 | 可使用文本编辑器、IDE或支持JSON的查看器打开。 | 用文本编辑器打开，并查看应用支持的 TOML 功能。 |
| 导出或转换 | 可使用应用程序或转换工具将其转换为CSV等格式。 | 从 JSON 或 YAML 转换时，解析后检查嵌套、数组、引号、日期和值类型。 |
按用途选择
传递结构化数据
Web API、配置文件和数据交换
JSON带结构化值的可读设置
应用程序和工具配置
TOML关键点 1
JSON 是标准化的结构化数据交换格式，其标准语法不包含注释。
进一步了解差异关键点 2
TOML 是配置文本格式，表格和数组的设计便于阅读与编辑。
进一步了解差异进一步了解差异
选择接收应用和工作流支持的格式。验证模式，并检查转换后日期、数字和数组等值是否保留预期类型。
- JSON 常用于 API 和可互操作的机器间数据交换。
- TOML 可让人工维护的设置更清晰，但并非所有要求 JSON 的服务都接受 TOML。
- 当配置会影响应用行为时，两者都需要解析器和模式校验。
常见问题
配置文件是否都应该用 TOML 而非 JSON？
不一定。应使用工具链要求的格式；TOML 可能更便于人工维护，但许多 API 和工具要求 JSON。
JSON 可以写注释吗？
标准 JSON 不支持注释。确实需要注释时，请使用明确支持注释的格式和解析器。