📖 工具说明

JSON 是 Web API 的标准语言，而 TOML (Tom's Obvious, Minimal Language) 凭借其极高的可读性，已成为 Rust (Cargo)、Go (Hugo) 和 Python (Pip) 等现代工具的首选配置文件格式。本工具支持双向、无损转换，让配置管理在“机器友好”与“人类友好”之间无缝衔接。

1. 核心应用场景

配置文件转换： 快速将项目中的 config.json 迁移为更易手动编辑的 config.toml，或反向转换以适配 API 调用。
DevOps 脚本编写： 在编写自动化部署脚本时，将复杂的 JSON 数据转化为 TOML 格式，提高配置文件的可维护性。
静态网站生成： 为 Hugo 或 Zola 等使用 TOML 定义 Front Matter 的工具快速准备元数据。
多语言栈对接： 在使用 Rust (Cargo.toml) 或 Go 等对 TOML 支持极佳的项目中，处理前端传来的 JSON 数据。

2. 核心功能解析

本站采用高精度解析引擎，确保数据结构在转换过程中不发生偏移：

A. 智能类型映射 (Lossless Conversion)

对象与表格： 将 JSON 的嵌套对象完美映射为 TOML 的 [table] 结构。
数组与集合： 自动处理 JSON 数组到 TOML [[array of tables]] 或普通数组的转换。
类型对齐：
- Number -> 智能推导为 Integer 或 Float。
- Boolean -> 对应 true/false。
- Null -> 由于 TOML 原生不支持 null，转换时支持可选的忽略或报错提示，确保生成的 TOML 合法。

B. 双向互转机制

JSON 转 TOML： 自动将扁平或嵌套的 JSON 结构“语义化”，生成带缩进的 TOML 代码。
TOML 转 JSON： 将易读的 TOML 解析为标准的 JSON 格式，方便用于网络传输或 JavaScript 环境。

C. 100% 本地化处理 (Data Privacy)

隐私物理防线： 所有转换逻辑均在您的浏览器本地执行。您的服务器 IP、数据库密码或私密 API 密钥绝不上传服务器。
瞬时生成： 即使是复杂的系统级配置文件，也能在毫秒间完成互转预览。

D. 代码美化与校验

语法高亮： 输入与输出均支持高亮显示，方便快速排查配置错误。
错误定位： 如果 JSON 或 TOML 存在语法缺陷（如括号未闭合），工具会即时给出详细的报错位置。

3. 操作流程简述

粘贴内容： 将数据粘贴至本站的“输入区”。
选择方向： * 点击“JSON ⮕ TOML”将 API 响应转为配置文件。
- 点击“TOML ⮕ JSON”将本地配置转为传输格式。
实时预览： 右侧输出窗口会立即显示转换后的代码。
复制下载： 点击“复制代码”或“下载文件” (支持 .json / .toml 扩展名)。

4. 转换规则参考

数据结构	JSON 表现	TOML 表现
基础对象	`{"key": "value"}`	`key = "value"`
嵌套对象	`{"user": {"id": 1}}`	`[user]\n id = 1`
对象数组	`[{"a": 1}, {"a": 2}]`	`[[root]]\n a = 1 ...`
混合类型	支持数组内嵌字典	支持标准 TOML 缩进规范

5. 为什么选择本站在线 JSON & TOML 互转？

遵循规范： 完美适配 TOML v1.0.0 标准，确保生成的代码可被所有现代解析器识别。
极简交互： 无需安装 CLI 工具（如 yq 或 toml-cli），浏览器即开即用。
专注开发者： 界面清爽，无广告弹窗，完美适配暗色开发环境。
完全免费： 不限次数，不限流量，致力于成为最实用的配置转换助手。

JSON和Toml互转

JSON

TOML