Tool Kumar 工具

JSON 转 TOML

把 JSON 配置转换为 TOML 表。嵌套对象变成表头,对象数组变成表数组。对于 TOML 无法表示的值,请查看输出中的注释。

如何使用这个工具

  1. 粘贴有效的 JSON 配置。
  2. 检查 TOML 表,以及关于被省略或被改动的值的注释。
  3. 复制或下载 TOML,然后对照你的应用配置 schema 进行校验。

示例演示

生成的 TOML 包含一个 [profile] 表和两个 [[items]] 表。值为 null 的 note 被省略,并附有一条注释。

输入

{
  "user-id": 42,
  "profile": {
    "city": "London",
    "created_at": "2026-10-14T09:00:00Z"
  },
  "items": [
    {
      "price": 12,
      "note": null
    },
    {
      "price": 12.5,
      "note": "gift"
    }
  ]
}

输出

user-id = 42

[profile]
city = "London"
created_at = "2026-10-14T09:00:00Z"

[[items]]
price = 12
# note = null (omitted: TOML has no null)

[[items]]
price = 12.5
note = "gift"

把配置迁移到使用 TOML 的技术栈

如果应用支持读取 TOML,可以使用转换后的数据,但请先检查该应用的 schema。Rust 的 Cargo.toml 和 Python 的 pyproject.toml 都要求特定的表和键;转换数据结构并不会替你生成这些项目文件。

在这个示例中,每个 item 都是一个单独的 [[items]] 表。第一个 note 因为是 null 而被省略。保存之前,请与源数据对比。

如果必须保留 null,请继续使用 JSON 或改用 YAML,不要直接接受已经改变数据的配置。

选项与特殊情况

  • TOML 没有 null 值。值为 null 的属性会被省略并附上注释,数组或内联表中的 null 元素会被直接丢弃。这种转换可能改变数据。
  • 超出有符号 64 位范围的整数会写成带引号的字符串,并附上说明注释。
  • TOML 文档必须是一个表,因此顶层的数组或标量会被包裹在一个键下,键名来自根名称设置(默认为 root)。
  • 字符串仍然是字符串,看起来像日期的值也一样。包含空格的键会加上引号。

默认保护隐私

你的文档只保留在这个浏览器中。Tool Kumar 在你的设备上解析、转换并生成下载文件,无需账号,也没有上传步骤。

JSON 转 TOML:常见问题

JSON 转 TOML 是无损的吗?
并非对所有文档都是。TOML 没有 null,整数也必须在有符号 64 位范围内。导出器会省略 null,并给超出范围的整数加上引号,同时用注释说明这些改动。
对象数组如何表示?
它们会变成表数组,例如 [[items]],每个对象对应一个表。
可以再转回 JSON 吗?
可以。对编辑后的配置使用“TOML 转 JSON”即可。被省略的 null 值无法自动恢复。
顶层 JSON 数组可以转成 TOML 吗?
可以。由于 TOML 要求文档根部是一个表,转换器会把它包裹在根名称下。

相关工具

TOML 转 JSON、JSON 转 YAML和JSON 校验工具。