.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 根文件必須為鍵值對資料表,因此頂層 JSON 陣列通常需包覆在 items 或 root 等鍵名下。

TOML 與傳統 INI 檔案相容嗎?

TOML 借鑑了 INI 的 [section] 語法,但具備正式 v1.0 規格,支援具型別整數、浮點數、布林、陣列與行內資料表。