首页 / 百科 / TOML

TOML

开发

语义明确的最小配置格式

TOML(Tom's Obvious Minimal Language,2013 年发布、1.0 版 2021 年定稿)是语义明确、无歧义的配置文件格式,被 Rust Cargo、Python pyproject.toml(PEP 518)等采纳为标准配置。

设计目标

作者 Tom Preston-Werner(GitHub 联合创始人)2013 年发布,目标是"人人可读、无歧义可映射为哈希表、易解析"。1.0.0 于 2021 年冻结规范——此后解析器行为完全稳定,这对配置格式是关键承诺。

语法要点

层级用 [section] 与 [section.sub] 表头表达;键值对 key = value;字符串、整数、浮点、布尔、日期时间(RFC 3339)均有明确类型;数组与内联表可组合。相比 YAML 没有"隐式类型陷阱",相比 JSON 有注释——介于两者之间取长。

谁在用它

Rust 的 Cargo.toml、Python 的 pyproject.toml(PEP 518/621,打包标准)、Go 模块代理配置、Hugo 静态站配置等。随着 Rust/Python 生态崛起,TOML 已成为"项目元数据"类配置的主流选择;运行时数据交换仍以 JSON 为王。

相关词条