.toml · application/toml
TOML: TOML 极简配置文件格式 (Tom's Obvious, Minimal Language)
TOML v1.0 采用类似 INI 的 [section] 节标题、显式字符串引号、原生日期时间与 # 注释,无歧义地映射为哈希表。
快速解答: TOML v1.0 采用类似 INI 的 [section] 节标题、显式字符串引号、原生日期时间与 # 注释,无歧义地映射为哈希表。 Rust Cargo.toml、Python pyproject.toml、Hugo/Netlify 配置及强类型应用设置。
| 结构类型 | 层级结构 |
|---|---|
| 人类可读性 | 高 |
| 支持嵌套 | 支持 |
| LLM Token 效率 | 中 |
| 文件扩展名 | .toml |
| MIME 类型 | application/toml |
| 适用场景 | Rust Cargo.toml、Python pyproject.toml、Hugo/Netlify 配置及强类型应用设置。 |
核心优势
- 彻底消除 YAML 的缩进脆弱性与隐式布尔值陷阱
- 支持注释、RFC 3339 原生时间戳与简洁的点分隔键语法
- 已成为 Rust、Python 打包规范及现代 CLI 工具的标准配置格式
局限与权衡
- 深层嵌套的对象数组写起来比 JSON 或 YAML 更显繁琐
- 顶层不能直接是数组,转换 JSON 顶层数组时需外包根表键
- 部分语言标准库缺乏原生内置解析器,不如 JSON 普及
参考资料
本地转换与清理 TOML
相关工程指南
相关格式
全部 24 种格式TOML 常见问题
为什么 Cargo 和 pyproject.toml 选择 TOML 而不是 YAML?
TOML 禁止裸写无引号字符串也不依赖缩进层级,确保包管理清单在任何环境下都能稳定解析并保留注释。
TOML 能直接表示顶层 JSON 数组吗?
不能。TOML 根文档必须是键值对表,因此顶层数组通常需要包在 items 或 root 等键名之下。
TOML 与传统 INI 文件兼容吗?
TOML 借鉴了 INI 的 [section] 语法,但提供了严谨的 v1.0 规范,原生支持整数、浮点、布尔、数组与行内表。