TOML 至 JSON

类型如何映射

输出始终使用 4 个空格缩进排版，因此数组和对象会展开成多行；上表为了便于阅读把值写在一行里。键的顺序与你 TOML 中出现的顺序完全一致。

完整示例

title = "My App"

[server]
host = "localhost"
port = 8080

[[users]]
name = "alice"
admin = true

会转换为：

{
    "title": "My App",
    "server": {
        "host": "localhost",
        "port": 8080
    },
    "users": [
        {
            "name": "alice",
            "admin": true
        }
    ]
}

支持的 TOML 与真实的限制

支持：[表] 表头（包括点分隔的区块名）、[[表数组]]、单行的 key = value 键值对、带 \n、\t、\" 转义的基本字符串 "..."、字面量字符串 '...'、简单十进制的整数和小数、true/false、单行数组（允许嵌套）、占据整行的 # 注释，以及按字符串传递的日期。

不支持的部分，以及对应的做法：

• 多行字符串（""" 或 '''）和多行数组会让解析器报错停止。请先把值写到一行里。
• 内联表不会被展开：point = { x = 1, y = 2 } 会输出为字符串 "{ x = 1, y = 2 }"，而不是对象。请把它改写成独立的 [point] 区块。Cargo.toml 的依赖行（例如 serde = { version = "1.0" }）就是典型情况。
• 等号左侧的点分隔键会保持为一个扁平键：server.host = "a" 生成的键是 "server.host"，不会嵌套。请改用 [server] 表头。表头里的点分隔 [section.names] 则能正确嵌套。
• 值后面的注释不会被剥离：port = 8080 # main 会变成字符串 "8080 # main"。注释请单独成行。
• 超出简单十进制的数字格式不会被识别：1_000、0xFF、5e2、+99、inf 和 nan 都会以带引号的字符串输出。请写成 1000、255、500、99。
• 基本字符串中的 \uXXXX 转义不会被解码。请直接粘贴真实字符。

如果要转换完整的 TOML 1.0 文档，请使用 toml2json 之类的命令行转换器，或先用 Python 的 tomllib 读取文件，再从那里输出 JSON。

适用场景

• 调试时把一段 TOML 快速查看为 JSON。
• 把简单配置值传给只接受 JSON 的 linter、脚本或资产清单工具。
• 用手写更顺手的 TOML 笔记生成 JSON 测试夹具。
• 迁移小而扁平的配置文件，Hugo 的很多 config.toml 就属于这一类。

往返转换须知

• 注释永远不会保留：JSON 根本没有注释语法。
• 日期仍是字符串；下游代码需要把它们重新解析成日期对象。
• 大数：JSON 文本中的整数保留为 64 位值，但 JavaScript 一侧在超过 2^53 后会丢失精度。留意纳秒级时间戳和数字 ID。
• 键的顺序在本转换器中保持书写时的样子；其他 JSON 工具重新输出文档时可能会重排键。

反向转换

JSON → TOML 才是更难走的路，因为 JSON 拥有 TOML 没有或处理方式不同的结构（深层匿名嵌套、null）。大多数往返场景都需要在 TOML 一侧手动调整。