在线JSON转TOML转换器

JSON对象怎样变成TOML配置

JSON 用大括号、方括号和冒号表达数据结构；TOML 主要用“键 = 值”、表头和数组表达配置。转换时，普通键值会成为赋值行，嵌套对象会成为表，例如 server 对象对应 [server]；对象数组会按数组表结构输出，例如 [[users]]。字符串、数字、布尔值和普通数组也会转换为对应的TOML写法。

官方 TOML 1.1.0 规范列出字符串、整数、浮点数、布尔值、日期时间、数组和表等类型；RFC 8259 的 JSON 类型中包含 null。由于 TOML 没有对应的 null 类型，本工具将输入中的 null 写成空字符串 ""，例如 {"nickname":null} 会得到 nickname = ""。这会改变该字段的含义，提交配置前要检查此类值。

嵌套对象和对象数组示例

输入 {"server":{"port":8080},"users":[{"name":"Lin"}]} 时，结果会包含 [server] 表头及 port = 8080，并为用户对象生成 [[users]] 和 name = "Lin"。顶层输入若是单个标量或数组，页面会将它放入名为 value 的键中，方便形成键值形式的TOML文本。

输入、检查和复制结果

1. 准备合法JSON

   复制一段完整JSON文本到输入区，也可以点击“示例”载入内置样例，或使用粘贴按钮读取剪贴板内容。

2. 查看自动转换

   输入变化时页面会尝试解析并更新右侧结果，无需额外点击转换按钮。JSON语法不合法时会显示错误信息，并暂不生成TOML。

3. 复核并复制

   检查表头、数组、字段名和特殊值，再用结果区的复制按钮复制文本。需要重新开始时点击清空。

键名和数组结构

只含英文字母、数字、下划线或连字符的键名通常不需要引号；包含空格、点号或其他字符的键名会加引号。普通数组保持方括号和逗号形式，数组中每一项都是对象时，会改用 TOML 的数组表写法。若输入是根层数组，结果会先生成 value = [...]，因为输出会为根值提供一个键。

配置迁移时怎么用

从接口样例整理配置：复制一段合法JSON响应中的配置对象，查看嵌套表和数组映射，再把确认后的TOML放入项目配置文件。

维护多组服务参数：把数组对象转换成数组表后，检查每个表项的键和值是否对应原JSON，尤其留意对象中嵌套的子对象。

排查解析问题：遇到红色错误提示时，先修正 JSON 引号、逗号和括号，再重新查看转换结果；带注释的 JSONC 或末尾多余逗号不是标准JSON输入。

转换中容易遇到的问题

为什么带注释或末尾逗号的JSON不能转换？

输入会按标准JSON解析，注释和末尾多余逗号不属于 RFC 8259 的标准语法。先删除这些内容并检查引号、逗号与括号是否配对，再重新粘贴。

JSON里的null会原样保留吗？

不会。TOML没有null类型，本工具把它写成空字符串；如果空字符串与“未提供值”的含义不同，请在复制结果后按目标配置要求手动处理。

为什么纯数组输出前会出现value？

该转换器会把根层数组或标量包装在 value 键中；若目标程序需要特定键名，可在结果中按配置约定修改并重新校验。

保存前核验数据含义

转换只改写文本格式，不会替你确认目标程序的配置约定。JSON中的长整数会先由页面的数字解析机制读取；ECMAScript 规定，超过 9007199254740991 的整数不保证可精确表示，因此长编号、精确金额或其他不能变化的数字应特别复核。小数也建议与原始输入逐项比较。

带凭据、密钥或连接信息的配置应按自身数据要求处理；复制输出前检查内容，避免将敏感配置粘贴到不适当的位置。