JSON vs TOML 概述

JSON和TOML都是流行的数据格式，但TOML（Tom's Obvious Minimal Language）专为配置文件设计，重点关注人类可读性。

快速比较

| 特性 | JSON | TOML |

|------|------|------|

| 语法 | 花括号 | INI风格 |

| 注释 | 无 | 有 |

| 可读性 | 良好 | 优秀 |

| 文件扩展名 | .json | .toml |

| 解析速度 | 较快 | 中等 |

| 采用度 | 普遍 | 增长中 |

语法示例

JSON配置

{
  "database": {
    "server": "192.168.1.1",
    "ports": [8001, 8002, 8003],
    "connection_max": 5000,
    "enabled": true
  },
  "servers": {
    "alpha": {
      "ip": "10.0.0.1",
      "dc": "eqdc10"
    },
    "beta": {
      "ip": "10.0.0.2",
      "dc": "eqdc10"
    }
  }
}

TOML配置

# 数据库配置
[database]
server = "192.168.1.1"
ports = [8001, 8002, 8003]
connection_max = 5000
enabled = true

# 服务器配置
[servers.alpha]
ip = "10.0.0.1"
dc = "eqdc10"

[servers.beta]
ip = "10.0.0.2"
dc = "eqdc10"

主要区别

注释

JSON：无原生注释支持

{
  "_comment": "使用变通方法添加注释",
  "setting": "value"
}

TOML：完整注释支持

# 这是一个适当的注释

setting = "value" # 行内注释也可以

可读性

TOML消除了视觉混乱：

键不需要花括号或引号
清晰的节标题
自然的表语法
更适合嵌套结构

数据类型

两者都支持：

字符串、整数、浮点数、布尔值
数组
嵌套结构

TOML附加功能：

日期和时间（原生）
内联表

# TOML原生日期时间
created = 2026-02-14T10:30:00Z

# 内联表
point = { x = 1, y = 2 }

何时使用JSON

Web API - 行业标准

数据交换 - 通用支持

JavaScript - 原生解析

性能 - 解析更快

工具 - 更多验证器和格式化工具

何时使用TOML

配置文件 - 更易读

Rust项目 - Cargo.toml标准

Python打包 - pyproject.toml

人工编辑 - 更容易维护

需要注释 - 配置中的文档

转换示例

TOML转JSON（Python）

import json
import tomli  # Python 3.11+内置tomllib

with open('config.toml', 'rb') as f:
    data = tomli.load(f)

with open('config.json', 'w') as f:
    json.dump(data, f, indent=2)

JSON转TOML（Python）

import json
import tomli_w

with open('config.json') as f:
    data = json.load(f)

with open('config.toml', 'wb') as f:
    tomli_w.dump(data, f)

常见用例

JSON优势

{
  "api_response": {
    "status": 200,
    "data": [
      {"id": 1, "name": "Item 1"},
      {"id": 2, "name": "Item 2"}
    ]
  }
}

TOML优势

# 应用配置
[app]
name = "MyApp"
version = "1.0.0"
debug = false

[app.database]
url = "postgresql://localhost/mydb"
pool_size = 10

[app.logging]
level = "info"
file = "/var/log/myapp.log"

常见陷阱

TOML表顺序

# 错误 - 不能在数组后添加到[fruit]
[fruit]
name = "apple"

[[fruit.varieties]]  # 表数组
name = "red"

[fruit]  # 错误！已定义
color = "red"

# 正确 - 首先定义所有表键
[fruit]
name = "apple"
color = "red"

[[fruit.varieties]]
name = "red"

决策指南

选择JSON当：

构建Web API
需要最大兼容性
性能至关重要
使用JavaScript/浏览器
以编程方式生成数据

选择TOML当：

编写配置文件
人类可读性是优先事项
注释必不可少
使用Rust或Python项目
配置需要版本控制审查

流行工具

JSON工具

jq（命令行处理器）
每种编程语言
各处在线格式化工具

TOML工具

tomli/tomllib（Python）
toml crate（Rust）
TOML Language Support（VS Code）
在线TOML验证器

生态系统采用

JSON：通用（1999年+）

所有Web浏览器
所有主要语言
REST API标准

TOML：增长中（2013年+）

Rust：Cargo.toml
Python：pyproject.toml
Hugo静态网站生成器
许多CLI工具

结论

JSON主导数据交换和API，而TOML在配置文件中表现出色。许多现代项目同时使用两者：运行时数据使用JSON，人工可编辑配置使用TOML。根据您的用例选择：如果人类经常编辑它，TOML的可读性获胜；如果机器生成它，JSON的通用性无与伦比。

JSON vs TOML：配置格式比较

Big JSON Team