TOML 转 JSON 转换器

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

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

const toml = `
[package]
name = "my-app"
version = "1.0.0"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
`;

const data = parse(toml);
const json = JSON.stringify(data, null, 2);

console.log(json);
// {
//   "package": { "name": "my-app", "version": "1.0.0" },
//   "dependencies": {
//     "serde": { "version": "1.0", "features": ["derive"] }
//   }
// }

核心功能

示例

[package]
name = "my-app"
version = "1.0.0"
edition = "2021"
authors = ["Jane Doe <jane@example.com>"]

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

[dev-dependencies]
criterion = "0.5"

[[bin]]
name = "my-app"
path = "src/main.rs"

[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"
]

[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.4"]

[tool.ruff]
line-length = 100

[build]
command = "npm run build"
publish = "dist"

[build.environment]
NODE_VERSION = "20"

[[redirects]]
from = "/old-path"
to = "/new-path"
status = 301
force = true

[[headers]]
for = "/*"

[headers.values]
X-Frame-Options = "DENY"

baseURL = "https://example.org"
languageCode = "en-us"
title = "My Hugo Site"
theme = "ananke"

[params]
description = "A static site built with Hugo"
mainSections = ["posts", "docs"]

[[menu.main]]
name = "Blog"
url = "/posts/"
weight = 1

[[menu.main]]
name = "About"
url = "/about/"
weight = 2

edition = "2021"
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true

title = "Deployment Log"
last_deployed = 1979-05-27T07:32:00Z
release_date = 1979-05-27
maintenance_window = 02:00:00

[[servers]]
name = "alpha"
ip = "10.0.0.1"
ports = [8001, 8002]

[[servers]]
name = "beta"
ip = "10.0.0.2"
ports = [9001]

如何使用

1. 1

   粘贴你的 TOML

   在上方输入框中输入或粘贴你的 TOML。你也可以点击「加载示例」来试用真实的 Cargo.toml、pyproject.toml 或部署配置。

2. 2

   查看实时 JSON 输出

   JSON 会即刻出现在输出面板。调整「缩进」选项（2 或 4 个空格）以匹配你的目标格式。日期、表和表数组都会被自动处理。

3. 3

   复制或下载

   点击「复制」把 JSON 抓到剪贴板，或点击「下载」保存为 .json 文件，供你的程序、API 或工具链直接使用。

常见 TOML 陷阱

name = my-app

name = "my-app"

name = "a"
name = "b"

name = "a"
alt_name = "b"

released = 2026-7-2

released = 2026-07-02

ports = [8001, 8002

ports = [8001, 8002]

snowflake = 1420070400000000000

snowflake = "1420070400000000000"

[servers]
name = "a"
[servers]
name = "b"

[[servers]]
name = "a"
[[servers]]
name = "b"

常见使用场景

Rust Cargo 元数据

把 Cargo.toml 转换为 JSON，用于构建依赖看板、审计 crate 版本与特性，或把清单数据喂给期望 JSON 而非 TOML 的脚本与 CI。

Python 项目配置

把 pyproject.toml 转换为 JSON，以查看 PEP 621 项目元数据、提取依赖列表，或驱动以编程方式读取打包配置的工具链。

部署配置检查

把 netlify.toml、foundry.toml 或其他平台配置转换为 JSON，用于审查重定向、响应头与构建设置，或为不同平台生成等价配置。

配置格式迁移

在迁移到偏好 JSON 的系统时，把 TOML 应用配置转换为 JSON，或作为用 jq 等 JSON 工具进一步转换前的中间步骤。

静态站点设置

把 Hugo 的 config.toml 转换为 JSON，用于迁移站点设置、跨环境对比配置差异，或构建以 JSON 为后端的设置界面。

API 与脚本输入

把人工编写的 TOML 转成 REST API、无服务器函数或自动化脚本可以直接消费的 JSON，在可读配置与机器输入之间架起桥梁。

技术细节

通过 smol-toml 进行 TOML 1.0.0 解析

TOML 使用 smol-toml 库解析，这是一个零依赖、完全符合 TOML 1.0.0 的解析器。它能正确处理嵌套表、点分键、内联表、表数组、多行字符串以及全部四种日期时间类型，并以行列位置报告解析错误。

无损日期时间与安全整数处理

TOML 日期时间会被序列化为保留其确切种类（带偏移日期时间、本地日期时间、本地日期、本地时间）的 JSON 字符串。超出 JavaScript 安全范围（2^53 - 1）的整数会在解析时提升为 BigInt，然后带着精度警告转换为最接近的 JSON 数字，因此有效的 TOML 永远不会转换失败。

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

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

最佳实践

把非常大的整数存为字符串

如果你的 TOML 含有超出 2^53 - 1 的整数（Snowflake ID、纳秒时间戳、大型计数器），请在转换前把它们加引号存为字符串。浏览器中的 JSON 数字无法精确保存它们，工具在不得不取整时会提醒你。

JSON 输出优先使用 2 空格缩进

两个空格的缩进是 JSON 使用最广泛的约定，能产生干净、可读、与大多数格式化工具和差异对比工具配合良好的输出。四个空格的缩进留给风格指南要求时再用。

使用前先验证 JSON 输出

转换后，如果你打算手动编辑该 JSON 或把它喂给某个严格的地方，请用我们的 JSON 格式化工具 运行一遍，以确认它有效且格式一致。

单独保留 TOML 注释

JSON 没有注释语法，因此 TOML 的 # 注释在转换时会被丢弃。如果这些注释是重要的文档说明，请在版本控制中把原始 TOML 与生成的 JSON 一并保留。

对重复的段落使用表数组

当你有多个相似的段落（servers、redirects、bins）时，请把它们写成表数组（[[section]]），而不是重复 [section]。它们会转换为干净的对象 JSON 数组，而不会引发重复表错误。

常见问题