TOML转JSON工具 - 配置文件格式转换

TOML（Tom's Obvious, Minimal Language）是一种专为配置文件设计的轻量级数据序列化语言，由 Tom Preston-Werner（GitHub 联合创始人）创建。它的设计目标是简洁、易读、无歧义，比 YAML 更严格，比 JSON 更适合人类编写。

常见使用场景：
• Rust 项目：Cargo.toml 是 Rust 的包管理配置文件
• Python 项目：pyproject.toml 用于定义项目元数据和构建配置
• Go 项目：许多 Go 工具使用 TOML 作为配置格式
• 静态站点生成器：如 Hugo、Zola 使用 TOML 作为前置元数据格式
• 通用配置文件：任何需要人类可读、可写配置的场景

TOML vs JSON：
• TOML 支持注释（# 开头），JSON 不支持注释
• TOML 的语法更宽松自然，键名可以不加引号
• JSON 的数据结构更通用，几乎所有编程语言都原生支持
• TOML 更适合人工编写和维护的配置文件

TOML vs YAML：
• TOML 使用显式的键值对和表头（[section]），结构更清晰
• YAML 依赖缩进表示层级，容易出错
• TOML 的类型系统更精确（明确区分整数、浮点数、日期时间等）
• YAML 功能更丰富但复杂度更高，TOML 更"最小化"

TOML 支持以下数据类型（均会被转换为对应的 JSON 类型）：

• 字符串："hello" 或 'hello'，支持多行字符串
• 整数：42，支持二进制、八进制、十六进制
• 浮点数：3.14，支持科学计数法
• 布尔值：true / false
• 日期时间：1979-05-27T07:32:00Z（转换为ISO字符串）
• 数组：[1, 2, 3]
• 表（哈希表）：[section] 和 key = {nested = true}
• 表数组：[[items]]（转换为JSON对象数组）

将 TOML 转换为 JSON 的常见原因：

• API 集成：大多数 Web API 和微服务使用 JSON 进行数据交换
• 前端消费：JavaScript/TypeScript 原生支持 JSON 解析
• 数据库存储：MongoDB、PostgreSQL 等数据库原生支持 JSON
• 配置迁移：从 TOML 配置迁移到 JSON 配置的系统
• 数据管道：在 ETL 流程中统一数据格式
• 调试分析：使用 jq 等 JSON 工具对配置数据进行查询和分析

转换时需要注意：

• 注释丢失：TOML 中的 # 注释在 JSON 中无法保留
• 日期时间格式：TOML 的日期时间类型会被转换为 ISO 8601 字符串
• 键名冲突：TOML 允许点分隔键名（如 a.b.c = 1），会展开为嵌套对象
• 表数组：[[array]] 语法会转换为对象数组，需确保结构一致
• 整数精度：大整数在 JSON 中可能丢失精度（JavaScript 安全整数范围为 ±2^53）
• 空表：TOML 中的空表在 JSON 中表示为 {}

常见 TOML 语法错误包括：

• 重复的键名：同一表内定义了相同的键
• 表头顺序错误：[a.b] 必须在 [a] 之后定义
• 类型混用：数组元素类型不一致（如 [1, "two"]）
• 字符串引号不匹配：忘记闭合引号
• 日期格式错误：日期时间格式不符合 RFC 3339 标准
• 缩进问题：虽然 TOML 不依赖缩进，但不一致的格式可能导致阅读困难
我们的工具会在转换时自动检测并提示这些错误。

本工具使用高效的 @iarna/toml 解析库，能够处理大多数常见规模的配置文件。对于大型文件（数MB以上），建议：

• 确保浏览器有足够的可用内存
• 关闭"自动转换"功能，手动触发转换以减少性能开销
• 使用本地命令行工具（如 toml2json 或 yq）处理超大文件
• 考虑将大型配置拆分为多个较小的 TOML 文件