TOML 转 JSON
表头、表数组、多行字符串都能正确解析
如何使用本工具
- 左边贴 TOML 或 JSON,方向选「自动识别」就不用管是哪一种。
- TOML 里的日期时间会保留成字符串,不会被转成时间戳,避免时区语义丢失。
- 转 TOML 时如果原 JSON 里有 null,会被跳过并在标签里提示,因为 TOML 没有空值。
- [[servers]] 这种表数组会转成 JSON 数组,反过来也能正确还原。
- 复制结果直接存成 config.toml 或 package.json。
常见问题
Q:TOML 为什么比 JSON 适合做配置文件?
A:因为它的注释是原生支持的,而 JSON 不允许注释(虽然 JSON5 和 JSONC 加了)。另外 TOML 有表头和表数组,表示嵌套结构时不用一路花括号,行内还能直接写日期类型。Cargo、pyproject、Hugo 这些工具都选了 TOML,JSON 更适合做数据交换格式。
Q:[[name]] 和 [name] 有什么区别?
A:[name] 定义一张表,同名表重复出现会报错;[[name]] 定义表数组,每出现一次就往数组里追加一个元素。所以 [[servers]] 写两次就是 servers 数组里有两个对象,转成 JSON 是 [{...}, {...}]。
Q:为什么 JSON 的 null 转不了 TOML?
A:因为 TOML 规范里没有 null 这个类型,只有布尔、数字、字符串、日期时间和它们的容器。遇到 null 只能选:跳过这个键、删掉整棵子树、或者转成空字符串。本工具选跳过并在标签里报告,这样你能知道哪些字段丢了。
Q:TOML 的日期是字符串吗?
A:不是,TOML 有四种独立的日期时间类型:偏移日期时间、本地日期时间、本地日期、本地时间。本工具转 JSON 时保留原始字符串,是刻意的取舍——JSON 没有日期类型,转成 ISO 字符串还能保住信息,转成时间戳则会丢掉「这是本地时间、不带时区」这个关键语义。
Q:点号键 a.b.c = 1 会被展开吗?
A:会。TOML 里 a.b.c = 1 等价于建三层表 [a] 里面 [b] 里面 c = 1,解析出来是 {a:{b:{c:1}}}。反过来从 JSON 生成 TOML 时,本工具会选择用表头而不是点号键,因为多层嵌套写点号键可读性更差。
Q:多行字符串的三种写法有什么差别?
A:基本多行用三个双引号,支持转义;字面多行用三个单引号,里面的反斜杠都是普通字符,适合写正则和 Windows 路径;还有紧跟在定界符后的第一个换行会被自动丢掉,这一点和直觉不同,很多人以为会多一个空行。