TOML 配置 (.toml)
TOML 标准Tom 的简明显式语言 (TOML) 是一种无歧义、以人为本的配置格式，由 GitHub 联合创始人 Tom Preston-Werner 创建，并在 Rust (Cargo) 和 Python (pyproject.toml) 等现代编程生态系统中广泛采用。
将 TOML 转换为 JSON
免费的浏览器端 TOML 转 JSON 转换器。在您的设备上即时转换文件。
检查与元数据
操作系统和文件分析器通过检查开头的二进制字节序列来识别 TOML 文件：
字节级文件头签名 (Magic Bytes)
操作系统和文件分析器通过检查开头的二进制字节序列来识别 TOML 文件：
十六进制签名 (偏移量 0)：
5B ... 5DASCII 表示形式： [...]
标准化： TOML v1.0.0 Specification
技术规格
| 容器架构 | Human-readable configuration file mapping unequivocally to a hash table, structured with [tables] and key = value pairs |
| 压缩方式 | Uncompressed text stream |
| 字节序 | UTF-8 text stream |
| 色彩空间 | N/A (Configuration File) |
| 通道与结构 | Tables, arrays of tables, inline tables, strings, integers, floats, booleans, and RFC 3339 datetimes |
| 最大尺寸 | Unbounded text length |
| 透明度 | None |
| 流式传输与渐进式加载 | Sequential line-by-line configuration parsing |
技术对比矩阵：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 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（语义化版本控制）。
- 每个 Rust 项目中的 'Cargo.toml' 文件都以 TOML 格式指定了所有包依赖项和编译器标志。
- 与 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。