.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 根文件必須為鍵值對資料表,因此頂層 JSON 陣列通常需包覆在 items 或 root 等鍵名下。
TOML 與傳統 INI 檔案相容嗎?
TOML 借鑑了 INI 的 [section] 語法,但具備正式 v1.0 規格,支援具型別整數、浮點數、布林、陣列與行內資料表。