JSON 与数据处理指南

TOML 转 JSON:表、点分键与类型边界

理解 TOML 表与表数组的 JSON 映射,检查日期、整数与注释的保真边界。

Nav Tools ·

把表映射成对象

表头建立对象路径,点分键表示嵌套结构,不是包含点号的字面属性。

先转换微型样例,再在 JSON 格式化中检查层级;带引号的 TOML 键则可以含字面点号。

[server]
port = 8080
limits.requests = 10
→ {"server":{"port":8080,"limits":{"requests":10}}}

明确使用表数组

双中括号表头向数组追加一张表,两条记录在 JSON 中保留为有序对象。

不要改成重复普通表头,TOML 对重新定义表有明确限制,并非同一种表达。

[[jobs]]
name = "first"
[[jobs]]
name = "second"

识别 JSON 无法原样保存的类型

TOML 有 JSON 不具备的日期时间类型,解析器日期对象序列化为文本后,反向转换可能无法恢复原类型。

TOML 整数范围也可能超出 JavaScript 安全整数,应使用保守样例并检查当前解析器的实际结果。

往返转换属于数据转换

注释、空白和原始表布局不会进入 JSON 值,往返转换不等于保留源码的编辑。

维护配置时保留原 TOML,修改后检查文本差异;JSON 结果适合查看值与路径。

参考资料

← JSON 与数据处理指南