在线TOML转JSON工具

什么是 TOML 和 JSON？什么时候需要转换？

一个软件项目的配置文件用 TOML 格式（比如 config.toml）写好了，但部署系统只认 JSON，这时候就需要把 TOML 转成 JSON。TOML（Tom's Obvious, Minimal Language）是一种专门写配置的轻量格式，常见于 Rust 的 Cargo.toml、Python 的 pyproject.toml 中。JSON（JavaScript Object Notation）是几乎所有编程语言和 API 都支持的数据交换格式。在我们的在线转换工具里，你只需把 TOML 文本粘贴到左侧输入框，点击“转换”按钮，右侧就会输出 JSON。

典型使用场景

• 部署配置迁移：你在本地用 TOML 写了开发配置，但服务器只接受 JSON 格式的环境变量文件。用这个工具转换一次，复制结果到服务器即可。
• 数据导入导出：某个第三方 API 或数据库只支持 JSON 格式的配置，而你手头只有 TOML 文件。用工具转成 JSON 后直接提交。
• 团队协作演示：向不熟悉 TOML 的同事分享配置示例时，转成 JSON 能让更多人直观理解结构。

完整转换示例

主算例：一份标准的 TOML 配置：

[server]
host = "127.0.0.1"
port = 8080

[database]
name = "testdb"
user = "admin"
password = "secret"

[features]
enable_ssl = true
allow_guests = false

在工具的“输入 TOML”框中粘贴以上内容，点击“转换”，右侧会显示：

{
  "server": {
    "host": "127.0.0.1",
    "port": 8080
  },
  "database": {
    "name": "testdb",
    "user": "admin",
    "password": "secret"
  },
  "features": {
    "enable_ssl": true,
    "allow_guests": false
  }
}

对照例：包含数组和日期时间的 TOML：

title = "Example"
numbers = [1, 2, 3]
created = 2023-08-15T10:00:00Z

转换后 JSON 中，日期变成了字符串：

{
  "title": "Example",
  "numbers": [1, 2, 3],
  "created": "2023-08-15T10:00:00Z"
}

注意 TOML 的数组原样保留，但日期被转成 ISO 8601 字符串（JSON 本身没有日期类型）。

结果怎么解读

转换成功后的 JSON 可以直接复制使用。你需要关注几个差异：

• 键名保持不变，但 TOML 中使用点分隔的键（如 a.b.c）会变成嵌套的 JSON 对象。
• 表数组（如 [[items]]）在 JSON 中变成对象数组，顺序与原 TOML 中出现顺序一致。
• 注释丢失：TOML 的 # 注释在 JSON 中不存在，转换后会被全部丢弃。

如果输入 TOML 有语法错误（如重复键、缩进不对），工具会显示错误提示，不会输出 JSON。

常见误用和易踩的坑

1. 忘记转义特殊字符：TOML 字符串内的双引号必须用反斜杠转义，否则解析失败。例如 say = "他问："你好"" 应该写成 say = "他问：\"你好\""。
2. 混淆整数与浮点数：TOML 中 5 是整数，5.0 是浮点数；JSON 会如实区分，不能混用。
3. 依赖注释说明：如果配置文件中用注释解释字段含义，转换后注释丢失，容易误解。建议转换前备份原始文件。
4. 表数组合并顺序：如果同一个表数组出现在两个不同位置（如 [[items]] 在文件头和文件尾重复），TOML 规范会合并它们，导致 JSON 数组顺序与预期不符。
5. 非标准日期格式：TOML 要求严格日期格式（如 2023-08-15T10:00:00Z），如果写成 08/15/2023 会被当作普通字符串。

常见问题 FAQ

1. 我的 TOML 包含中文能正常转换吗？可以。TOML 和 JSON 都支持 UTF-8 编码，中文会原样保留。
2. 转换后的 JSON 和原 TOML 完全等价吗？不完全等价。JSON 没有注释、日期类型会变成字符串、不支持隐式表结构。关键数据一致，但元信息丢失。
3. 工具支持一次性转换多个 TOML 文件吗？目前只支持粘贴单段文本。如果需要批量处理，建议使用命令行工具（如 toml2json）。
4. 为什么我的 TOML 报语法错误？检查缩进是否使用空格（不要用 Tab）、键是否重复、字符串是否转义。也可以去在线 TOML 验证器先检测。
5. 转换后的 JSON 能否得到压缩版本（去掉空格）？默认输出是带缩进的美化格式。如果需要压缩版，可以把结果复制到任意 JSON 压缩工具处理。
6. 如果 TOML 包含敏感信息（如密码）转换安全吗？工具只运行在浏览器中，不会上传你粘贴的内容到服务器。但为了绝对安全，建议在离线环境下使用。

注意事项与局限

• 本工具严格遵循 TOML v1.0.0 规范，但不支持部分边缘特性（如行尾反斜杠续行、内联表内的多余空格）。遇到不支持的语法会提示错误。
• 数字精度受限于 JavaScript 的 Number 类型，超过 2^53 的整型数值可能丢失精度。
• 转换结果仅供参考或临时使用；涉及生产环境的关键配置，建议手动核对转换后的 JSON。
• 如果工具无法正常转换，请尝试将 TOML 内容简化后分步转换。

现在你可以在上方计算器里试试自己的 TOML 文件。