ガイド

JSON vs YAML vs TOML vs .env:設定ファイル形式の使い分けガイド

JSON、YAML、TOML、.env の 4 つの設定フォーマットをコメント対応・ネスト・シークレット安全性・用途別で比較し、ローカルで安全に変換します。

読了目安 2分

クイックアンサー: 厳密な API スキーマには `.json`、Kubernetes や CI 定義には `.yaml`、開発ツールの明示的設定には `.toml`、フラットな実行時シークレットには `.env` が適しています。TxtTo は 4 形式の相互変換をブラウザ RAM 内で完結させ、機密キーの漏洩を防ぎます。

用途に合った設定フォーマットの選び方

すべての設定レイヤーに万能な単一フォーマットはありません。機械生成されるマニフェストには JSON、インフラ定義には YAML、言語ツールのマニフェストには TOML、実行時シークレットには `.env` が適しています。

各形式のパーサー挙動を理解しておくことで、引用符忘れによる YAML の誤型変換や認証情報の誤コミットといった本番障害を防げます。

  • JSON:曖昧さゼロ・コメント不可・システム間連携の共通言語。
  • YAML:マルチドキュメント `---` と `#` コメント対応。インデントに敏感。
  • TOML:明示的な `[tables]` と厳密な文字列引用符。Rust/Python 向けに最適。
  • .env:Git 管理外に置くフラットな実行時 `KEY=VALUE` シークレット。

YAML 特有の暗黙的な型変換トラップを回避する

YAML 1.1 では引用符なしの `NO`、`on`、`off`、`yes` といった値が文字列ではなく真偽値 `false` / `true` に変換されます。YAML マニフェストを JSON へ変換して確認すれば、意図しない型変換やインデントずれを即座に発見できます。

yaml
# YAML trap: unquoted NO becomes boolean false in YAML 1.1
country: "NO"
port: 8080
tags:
  - edge
  - cache

YAML を検証して JSON へ変換する

開発パッケージ設定で TOML が選ばれる理由

TOML は裸の文字列を禁止しインデント空白で構造が変わらないため、`Cargo.toml` や `pyproject.toml` でタブとスペース混在による破損が起きず、`#` コメントで設定意図も残せます。

TOML ⇄ JSON をローカルで相互変換する

.env シークレットをオフラインで安全に変換する

DB 接続 URL や JWT シークレット、API キーを含む `.env` ファイルをサーバー送信型のオンライン変換ツールに貼り付けてはいけません。TxtTo は `.env ⇄ JSON` の変換を完全にブラウザメモリ内で実行するため外部へ一切送信されません。

.env シークレットをオフラインで JSON 化する

参考文献

よくある質問

--- 区切りを含む Kubernetes のマルチドキュメント YAML も変換できますか?

はい。「マルチドキュメント YAML (---) に対応」を有効にすれば、1 ファイル内の複数ブロックを JSON 配列としてまとめて変換できます。

JSON から TOML に変換する際、コメントは引き継がれますか?

JSON 自体はコメントを持たないため、整形された純粋な TOML テーブルが出力されます。その後必要に応じて # コメントを追記してください。

.env to JSON では PORT=8080 や DEBUG=true を数値や真偽値に変換できますか?

はい。「数値・真偽値を自動型変換」をオンにすると適切な JSON 型に変換され、オフにするとすべての値を文字列のまま保持します。

関連フォーマット

関連比較ページ

関連ガイド