如何将 TOML 配置转换为 JSON

先了解输入与转换范围

TOML 常用于保存层次清晰的配置，而 JSON 更方便交给其他程序继续读取或处理。本工具的用途是把输入的 TOML 配置文本转换成 JSON 表示，适合需要改变配置数据格式的场景。输入可以包含字符串、数字、布尔值和嵌套表格，日期、时间及日期时间值会以 ISO 格式字符串呈现在结果中。转换前应先确认文本符合 TOML 语法，因为格式错误的内容不会被转换成有效结果。

按设置完成 TOML 转换

准备需要处理的 TOML 文本，并检查键值、引号、表格声明和嵌套关系是否完整。文本通过可选的输入项提供；如果当前没有内容，也可以暂时保持为空。
将 TOML 粘贴到输入区域，按照结果的阅读需求设置 JSON 缩进数值。未另行设置时，缩进默认使用 2。
根据后续使用方式决定是否启用键排序。默认情况下不会启用排序；选择该选项后，结果中的键会按照键名排列。
执行转换并查看生成的 JSON 表示，重点检查层次结构、值的类型和日期时间字段的写法。嵌套表格应体现为对应的嵌套对象，普通标量值则映射到相应的 JSON 数据。
如果输入框只含空白，转换会成功并显示空 JSON 对象表示。若没有得到转换结果，应回看原始 TOML 的语法；JSON 序列化阶段发生问题时，也会返回失败状态。

从结果判断转换是否完成

成功结果是由 TOML 数据形成的 JSON 表示，而不是对原始文本的逐字符复制。缩进数值改变的是 JSON 的排版层次，通常用于提升查看时的清晰度；键排序选项改变的是键的排列方式，并不表示配置值已经被修改。日期、时间和日期时间会以 ISO 格式字符串出现，因此后续使用结果时应按字符串读取这些字段。空输入得到空 JSON 对象属于成功情形，不应与有内容但语法错误的 TOML 混淆。若转换失败，应把结果视为未完成的转换，并回到输入内容检查，而不能据此认为原配置已被修复。

使用示例

你要把一段含有应用名称、端口和数据库配置的 TOML 文本整理成便于后续处理的 JSON。

以包含 app.name、port、[database] 表格和 created 日期时间字段的 TOML 文本为输入，将缩进设为 4 并启用键排序后执行转换。

结果呈现为 JSON 对象，顶层配置保持对象结构，数据库表格对应嵌套对象，日期时间字段显示为 ISO 格式字符串；键的排列取决于是否启用排序。

使用限制

该转换不会修复不符合语法的 TOML；解析失败或 JSON 序列化阶段出现问题时，结果会以失败状态返回。

常见错误

原因：输入中的键值、引号或表格结构不符合 TOML 语法。改正：定位不完整的语句并修正原文后重新提交，避免把失败状态当成已经生成的 JSON。

常见问题

不填写 TOML 也能进行转换吗？

可以，但结果只表示为空的 JSON 对象。输入区域没有内容或只有空白时会成功；如果输入了实际 TOML，则仍需保证语法能够正确解析。

可以控制缩进和键的排列吗？

可以通过缩进数值调整 JSON 的排版，并选择是否按照键名排列结果中的键。缩进默认值为 2，键排序默认处于关闭状态。

哪些 TOML 内容可以转换？

支持字符串、数字、布尔值以及嵌套表格等 TOML 数据。日期、时间和日期时间会变成 ISO 格式字符串，但语法不正确的 TOML 可能使转换失败。