TOML 配置 (.toml)
TOML 标准Tom 的显而易见的极简语言（TOML）是一种明确无歧义、以人为本的配置格式，由 GitHub 联合创始人 Tom Preston-Werner 创建，并广泛用于 Rust（Cargo）和 Python（pyproject.toml）等现代编程生态系统。
将 TOML 转换为 JSON
免费的浏览器端 TOML 转 JSON 转换器。在您的设备上即时转换文件。
检查与元数据
操作系统和文件分析器通过检查开头的二进制字节序列来识别 TOML 文件：
字节级文件头签名 (魔数)
操作系统和文件分析器通过检查开头的二进制字节序列来识别 TOML 文件：
十六进制签名 (偏移量 0)：
5B ... 5DASCII 表示形式： [...]
标准化： TOML v1.0.0 Specification
技术规格
| 容器架构 | 面向人类阅读的配置文件，可明确无歧义地映射为哈希表，并以 [tables] 和 key = value 键值对组织内容 |
| 压缩方式 | 未压缩文本流 |
| 字节序 | UTF-8 文本流 |
| 色彩空间 | 不适用（配置文件） |
| 通道与结构 | 表、表数组、内联表、字符串、整数、浮点数、布尔值和 RFC 3339 日期时间 |
| 最大尺寸 | 文本长度不限 |
| 透明度 | 不支持 |
| 流式传输与渐进式加载 | 支持逐行顺序解析配置 |
技术对比矩阵：TOML 对比同类产品
| 技术属性 | TOML (当前) | YAML | JSON | INI |
|---|---|---|---|---|
| 歧义风险 | 无（严格无歧义的规范） | 高（YAML 的“挪威问题”布尔值解析错误） | 无（严格的数据类型） | 中等（无正式标准） |
| 原生日期时间类型 | 原生支持 RFC 3339 日期和时间 | 隐式字符串/日期解析 | 无（仅限字符串） | 无（仅限字符串） |
| 注释支持 | 原生（# 注释） | 原生（# 注释） | 不允许注释 | 原生（; 和 # 注释） |
| 主要生态系统 | Rust（Cargo）、Python（PEP 518）、Go | Kubernetes、Ansible、CI/CD 管道 | Web API、浏览器通信 | 传统 Windows、Git 配置 |
常见损坏模式与十六进制恢复指南
解析器报错：“Duplicate key in table”（表中键重复）或“Invalid table header”（表头无效）。
根本原因: 尝试在文档中重新定义现有的键或表命名空间。
恢复方法: 使用 File2File.app TOML 格式化工具验证并重新格式化 TOML 语法。
安全分析与解析器攻击向量
TOML 解析器必须防范原型污染以及病态表数组嵌套导致的 CPU 耗尽。
已知攻击向量
- JavaScript TOML 解析器发生原型污染，将属性注入 Object.prototype。
- 通过深度嵌套的表数组声明发起拒绝服务攻击。
- 在解析大量内联数组时发生不受限制的内存分配。
防御性最佳实践: 验证表嵌套限制并使用防范原型污染的字典对象。
历史渊源与里程碑
2021TOML v1.0.0 正式发布，冻结了核心语法规范。
2018Python 将 'pyproject.toml' (PEP 518) 标准化为现代构建配置标准。
2013Tom Preston-Werner 发布 TOML，旨在提供一种没有 YAML 复杂性的干净配置格式。
核心优势与特点
- 完全没有歧义：可清晰、可预测地映射为哈希表，不会意外强制转换类型。
- 原生支持日期时间（RFC 3339 时间戳、日期和时间），无需将其转义为字符串。
- 被采纳为现代编程语言工具的官方标准配置格式（如 Rust 的 Cargo.toml、Python 的 pyproject.toml）。
技术局限与劣势
- 与 YAML 相比，深度嵌套的多级对象树可能会显得冗长。
- 对于初学者来说，表数组的语法 ([[table.array]]) 可能不够直观。
- 对于高吞吐量的机器到机器 API 数据交换，不如 JSON 紧凑。
趣味技术冷知识
- TOML 由 Tom Preston-Werner 创建，他还共同创立了 GitHub，并创建了 Gravatar 和 SemVer（语义化版本控制）。
- Cargo 包使用 Cargo.toml 声明元数据、依赖项和构建目标；使用其他构建系统的 Rust 项目可能采用不同文件。
- 与 JSON 不同，TOML 原生支持注释（使用 '#' 字符）和多行字符串。
常见技术问题
TOML 的用途是什么？
TOML 用于软件配置，最常见的应用包括 Rust 的 Cargo.toml、Python 的 pyproject.toml、Go 的 Hugo 配置以及容器工具。
为什么在配置方面更倾向于使用 TOML 而不是 YAML？
TOML 避免了 YAML 中臭名昭著的边界解析错误（例如未加引号的“NO”被解析为布尔值 false），同时支持注释和清晰的表结构，便于阅读。
如何将 TOML 转换为 JSON 或 YAML？
您可以直接在网页浏览器中使用 File2File.app，即时将 TOML 文件转换为 JSON 或 YAML。