JSON 转 TOML 转换器

什么是 TOML，为什么要从 JSON 转换？

// Convert JSON to TOML in Node.js using the smol-toml library
import { stringify } from 'smol-toml';

const data = JSON.parse(`{
  "package": { "name": "my-app", "version": "1.0.0" },
  "dependencies": { "serde": { "version": "1.0" } }
}`);

// The top-level value must be an object; null values on objects are dropped.
const toml = stringify(data);

console.log(toml);
// [package]
// name = "my-app"
// version = "1.0.0"
//
// [dependencies.serde]
// version = "1.0"

核心功能

示例

{
  "package": {
    "name": "my-app",
    "version": "1.0.0",
    "edition": "2021"
  },
  "dependencies": {
    "serde": { "version": "1.0", "features": ["derive"] },
    "tokio": { "version": "1", "features": ["full"] }
  }
}

{
  "build-system": {
    "requires": ["hatchling"],
    "build-backend": "hatchling.build"
  },
  "project": {
    "name": "my-package",
    "version": "0.3.1",
    "requires-python": ">=3.10",
    "dependencies": ["requests>=2.31", "pydantic>=2.0"]
  }
}

{
  "title": "My Service",
  "debug": false,
  "port": 8080,
  "database": {
    "host": "localhost",
    "port": 5432,
    "pool_size": 10
  },
  "features": ["auth", "metrics", "tracing"]
}

{
  "servers": [
    { "name": "alpha", "ip": "10.0.0.1", "ports": [8001, 8002] },
    { "name": "beta", "ip": "10.0.0.2", "ports": [9001] }
  ]
}

{
  "build": {
    "command": "npm run build",
    "publish": "dist",
    "environment": { "NODE_VERSION": "20" }
  },
  "redirects": [
    { "from": "/old", "to": "/new", "status": 301, "force": true }
  ]
}

{
  "tool": {
    "ruff": { "line-length": 100, "target-version": "py310" },
    "black": { "line-length": 100 }
  }
}

如何使用

1. 1

   粘贴你的 JSON

   在上方输入框中输入或粘贴你的 JSON。你也可以点击「加载示例」来试用 Cargo.toml 源、pyproject.toml 源或应用设置对象。

2. 2

   查看实时 TOML 输出

   TOML 会即刻出现在输出面板。如果你的 JSON 有顶层数组或 null 值，工具会准确解释该怎么做，而不是产出损坏的输出。

3. 3

   复制或下载

   点击「复制」把 TOML 抓到剪贴板，或点击「下载」保存为 .toml 文件，供 Cargo、Poetry、Hugo、Netlify 或任何读取 TOML 的工具直接使用。

常见 JSON 转 TOML 陷阱

[1, 2, 3]

{ "items": [1, 2, 3] }

{ "name": "a", "nickname": null }

{ "name": "a", "nickname": "" }

{ "ports": [8001, null, 8003] }

{ "ports": [8001, 8003] }

{ 'name': 'a', 'active': true, }

{ "name": "a", "active": true }

{ "ratio": 1.0 }  →  ratio = 1

{ "ratio": 1.5 }  →  ratio = 1.5

{ "server": { "a": 1 }, "server": [1] }

{ "server": { "a": 1 }, "servers": [1] }

常见使用场景

生成 Cargo.toml

把结构化的 JSON — 来自脚手架工具、API 或脚本 — 转成有效的 Rust Cargo.toml，自动产出嵌套的 [dependencies] 表和内联表。

生成 pyproject.toml

把 JSON 项目元数据转换为 PEP 621 的 pyproject.toml，包括点分的 [tool.*] 表，让产出 JSON 的工具链能够生成 Python 打包配置。

从 JSON 生成人可编辑的配置

把应用的 JSON 设置转变为可读的 TOML 配置文件，让人可以舒适地编辑，之后再手动加上注释。

部署配置生成

从 JSON 产出 netlify.toml、foundry.toml 或类似的平台配置，把嵌套对象和对象数组变成那些工具期望的表和表数组。

配置格式迁移

把配置从基于 JSON 的系统迁移到基于 TOML 的系统，用本转换器作为桥梁，并借助 null 与顶层警告来捕捉任何无法映射的内容。

原型化 TOML 结构

用 JSON 勾勒一份配置 — 一种大多数开发者都能流畅书写的格式 — 然后转换为 TOML，在把它提交到仓库前查看惯用的表与表数组布局。

技术细节

RFC 8259 JSON 解析

JSON 输入使用浏览器原生的 JSON.parse() 解析，它完全符合 RFC 8259。在序列化之前，工具会检查顶层值是否为对象，并扫描 null 值，以便对被丢弃的对象键发出警告，或以精确路径拒绝数组内部的 null。

通过 smol-toml 输出 TOML 1.0.0

TOML 使用 smol-toml 库生成，这是一个零依赖、完全符合 TOML 1.0.0 的序列化器。嵌套对象变成表，深度嵌套对象变成点分表，对象数组变成表数组。小数部分为零的浮点数会按 TOML 规则写作整数，并附带一条警告。

100% 基于浏览器 — 无上传、无服务器

所有处理都在你浏览器的 JavaScript 引擎中进行。任何时刻都不会传输数据。大于 200KB 的输入会从实时切换到手动模式（需显式点击「转换」），以保持界面响应流畅。

最佳实践

把顶层数组包在一个键下

如果你的数据天生就是 JSON 数组，请在转换前把它包在一个带描述性键的对象里（{ "items": [...] }）。TOML 文档的根必须是一个表，而这个键会在输出中给你的数组一个清晰的名字。

决定 null 应该表示什么

在转换前，决定 null 字段应该消失（丢弃该键）还是携带一个值。TOML 会丢弃对象中的 null 并拒绝数组中的 null，因此先在你的 JSON 中解决它们，能得到可预测、完整的输出。

用嵌套对象进行分组

把相关的设置分组到你 JSON 中的嵌套对象里 — 它们会在 TOML 中变成干净的 [表] 和点分表，比一大堆扁平的键可读得多，也与 Cargo 和 pyproject 配置的组织方式一致。

先验证你的 JSON

如果你的 JSON 是手写的或来自不可靠的来源，请用我们的 JSON 格式化工具 验证它，在转换为 TOML 前捕捉尾随逗号和引号错误。

转换后再添加注释

JSON 没有注释，因此不会有任何注释被带过来。由于 TOML 支持 # 注释，请手动给生成的 TOML 加上文档说明 — 这本就是把人工编辑的配置迁移到 TOML 的主要原因之一。

常见问题