TOML 和 JSON 的关系
两者都是配置格式,表达的数据结构几乎一样(字符串、数字、布尔、日期、数组、表),区别在写法:JSON 用大括号和引号,TOML 用 [表名] 分段、key = value 赋值,更适合人手写。Rust 的 Cargo.toml、Python 的 pyproject.toml 都用它。
转换时注意什么
- 键的顺序:TOML 里普通键必须写在表之前,否则会被归到上一个表里。本工具自动把标量键提到前面。
- 空数组:TOML 无法表达「元素类型未知的空数组」,会输出
[],部分解析器会报错。 - null:TOML 没有 null,转换时会跳过值为 null 的键。
- 嵌套过深:TOML 用点号表名表达嵌套,层级超过五六层时可读性会明显变差,考虑改用 JSON。
功能说明
JSON 与 TOML 互转
TOML 是 Rust 生态的标配配置格式(Cargo.toml),Python 的 pyproject.toml 也用它,很多静态站点工具同样支持。但多数 API 只认 JSON,于是「把接口返回的 JSON 转成 TOML 配置」或者反向做验证,成了很常见的需求。
支持的语法范围
- 基本类型:字符串(含多行与转义)、整数、浮点数、布尔、日期时间。
- 表:
[section]与嵌套[a.b],以及内联表{ a = 1 }。 - 数组:普通数组、多行数组、数组表
[[items]]。 - 注释:解析时忽略
#之后的内容。 - 点号键:
a.b = 1会展开成嵌套对象。
TOML 转 JSON 常见报错
- 重复定义表:
[a]写了两次,或者既写了[a]又写了[a.b]之外的冲突结构。 - 值没加引号:字符串必须用双引号,
name = hello是非法的。 - 数组里混类型:TOML 1.0 要求数组元素类型一致。
- 键名带特殊字符:含空格或中文时要加引号,如
"我的键" = 1。
为什么不用在线 API
配置文件里常有密钥、令牌、内网地址。本工具全部在浏览器里解析和转换,内容不会离开你的电脑,这也是本站所有转换类工具的统一做法。
使用步骤
1. 在「输入框」中粘贴要处理的内容。
2. 点击「JSON → TOML」按钮执行。
3. 确认结果无误后,用「复制」保存到本地。
常见问题
JSON与TOML互转能做什么?
JSON 与 TOML 双向互转:支持表、数组、数组表、内联表、日期与布尔值,转换结果按 TOML 规范排版。写 Cargo.toml。全部处理在浏览器本地完成,无需注册、无需安装。
支持哪些格式互转?
支持 JSON、XML、YAML、CSV 等结构化文本格式。源格式不合规范时转换会失败或丢字段,建议先校验再转。
转换过程会丢信息吗?
存在能力差异时就会丢:比如带样式的内容转纯文本会失去排版,嵌套结构转平面表格会拍平层级。转换前想清楚下游要用哪些字段,只保留需要的部分更稳。
大文件转换会不会卡住?
解析和重新序列化都在内存里完成,文件越大越吃内存。几 MB 的文本通常瞬间完成,几十 MB 时浏览器可能卡顿甚至崩溃,建议先拆分。
你可能还想问
这个工具需要联网才能用吗?
第一次打开页面需要联网加载,之后的计算与处理都在本地完成,断网也能继续操作。数据不经过服务器,也不受网络波动影响。
处理结果怎么保存或分享?
结果区支持一键复制,也可按页面提供的下载入口保存到本地;页面不做云端存储,关掉浏览器后需要重新处理。
速查在线工具箱