.toml · application/toml

TOML: TOML(設定ファイル向け最小記述言語)

TOML v1.0 は INI 風の [セクション] 見出し、明示的な文字列引用符、日時型、# コメントを備え、ハッシュテーブルへ曖昧さなく対応付けられる設定形式です。

クイックアンサー: TOML v1.0 は INI 風の [セクション] 見出し、明示的な文字列引用符、日時型、# コメントを備え、ハッシュテーブルへ曖昧さなく対応付けられる設定形式です。 Rust の Cargo.toml、Python の pyproject.toml、Hugo/Netlify 設定、型が明確なアプリ設定。

構造タイプ階層構造
可読性高
ネスト対応対応
LLM トークン効率中
拡張子.toml
MIME タイプapplication/toml
主な用途Rust の Cargo.toml、Python の pyproject.toml、Hugo/Netlify 設定、型が明確なアプリ設定。

メリット

  • YAML 特有のインデント崩れや暗黙的な真偽値変換の罠を排除
  • コメント、RFC 3339 日時リテラル、簡潔なドット区切りキーに対応
  • Rust や Python パッケージ管理、各種 CLI ツールの標準設定フォーマット

注意点・トレードオフ

  • 深くネストされたオブジェクト配列は JSON や YAML より記述が長くなりやすい
  • ドキュメントの最上位に配列を直接置くことができずルートテーブルが必要
  • 標準ライブラリでのネイティブ対応は JSON より少ない

参考文献

TOML をローカルで変換・整形

関連エンジニアリングガイド

関連フォーマット

全24形式を見る

TOML に関するよくある質問

Cargo や pyproject.toml が YAML ではなく TOML を採用している理由は何ですか?

TOML は裸の文字列やインデントによる暗黙構造を禁止しているため、どの環境でもコメント付きのまま一意にパースでき安全性が高いためです。

TOML の最上位に直接 JSON 配列を表現できますか?

いいえ。TOML のルート文書は必ずキーと値のテーブルである必要があるため、配列は items などのキー配下に格納します。

TOML は従来の INI ファイルと互換性がありますか?

[section] 記法を踏襲しつつも、整数・浮動小数点数・真偽値・配列・インラインテーブルを厳密に定義した v1.0 仕様を持ちます。