.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

相关工程指南

TOML 常见问题

为什么 Cargo 和 pyproject.toml 选择 TOML 而不是 YAML?

TOML 禁止裸写无引号字符串也不依赖缩进层级,确保包管理清单在任何环境下都能稳定解析并保留注释。

TOML 能直接表示顶层 JSON 数组吗?

不能。TOML 根文档必须是键值对表,因此顶层数组通常需要包在 items 或 root 等键名之下。

TOML 与传统 INI 文件兼容吗?

TOML 借鉴了 INI 的 [section] 语法,但提供了严谨的 v1.0 规范,原生支持整数、浮点、布尔、数组与行内表。