.env ファイルを JSON に変換する
.env ファイルは環境設定を KEY=VALUE 形式で保存します。JSON に変換すると、構造化されたアクセス、型キャスト、バリデーションが可能になります。
- 1
.env ファイルは KEY=VALUE ペアを 1 行に 1 つ含み、コメント(#)と引用符をオプションで持てます。環境固有の設定(データベース URL、API キー、フィーチャーフラグ)に使われます。JSON に変換すると、型キャスト、ネスト、スキーマ検証が可能になります。
- 2 TOML コンバーター →
.env ファイルを key=value ペアとしてパースし、JSON に変換します。各行がトップレベルキーになります。引用符付きの値は文字列、引用符なしの数値は数値、true/false はブール値にキャストされます。
- 3 JSON フォーマッター →
変換された JSON をフォーマットします。.env ファイルはフラット(ネストなし)なので、JSON もフラットなオブジェクトになります。ネストが必要な場合(DATABASE_HOST、DATABASE_PORT → database: {host, port})は、命名規則パーサで JSON を後処理してください。
- 4
セキュリティ:.env ファイルは絶対にバージョン管理にコミットしないでください(.gitignore に追加)。API キーやデータベースパスワードなどのシークレットを含むことが多いからです。JSON に変換してもこれは変わりません。JSON ファイルも gitignore してください。本番環境にはシークレットマネージャ(Vault、AWS Secrets Manager)を使ってください。
よくある質問
- 設定には .env と JSON のどちらを使うべきですか?
- 環境ごとに異なるデプロイ固有の値(シークレット、URL)には .env を使います。ネストと型の恩恵を受けられる構造化設定(フィーチャーフラグ、UI 設定)には JSON または TOML を使います。目的が異なるため共存できます。
- .env の複数行の値はどう扱いますか?
- 引用符を使います:KEY="line1\nline2"。これをサポートする .env パーサもあれば、しないものもあります。複数行の値が必要な場合は、JSON または YAML の検討を。変換ツールは引用符付きの複数行の値を正しく処理します。
このタスクを解決するワークフロー
JSON 経由で 2 つの YAML 設定を比較
構造化された値の差分比較しやすいように、YAML 設定を JSON に変換する。 パイプライン
URL 転送用の JSON ペイロードのエンコード
JSON ドキュメントを URL パラメータ用に準備する: 整形、Base64 エンコード、パーセントエンコード — ネストされたパラメータデコードチェーンの正確な逆順。 パイプライン
HJSON から JSON フォーマットへ変換
HJSON をフォーマットし、標準 JSON に変換する。 パイプライン
JSON フォーマットと整合性チェックサム計算
JSON ドキュメントを整形し、以降の変更を検出するために CRC32 チェックサムを計算する。 パイプライン
JSON のミニファイと検証
検査のために JSON をフォーマットし、1 パスで構文的に正しいことを検証する。 パイプライン
JSON フォーマットと TypeScript インターフェース生成
JSON ドキュメントをフォーマットし、1 チェーンで TypeScript インターフェース定義を推論する。 パイプライン
検証、フォーマット後 JSON から YAML へ変換
(ミニファイの可能性がある)JSON 設定を YAML に変換し、微妙に誤った YAML を生成成する代わりに最初のノードで構文エラーを捕捉する。 パイプライン
JSON5 から JSON フォーマットへ変換
JSON5 をフォーマットし、標準 JSON に変換する。 パイプライン
JSONC から JSON フォーマットへ変換
JSONC(コメント付き JSON)をフォーマットし、標準 JSON に変換する。 パイプライン
JWT ペイロードのデコードとフォーマット
JWT トークンを解析し、ペイロードを抽出し、検査のために JSON をフォーマットする。 パイプライン
クエリ文字列解析と JSON フォーマット
クエリ文字列をキー・バリューペアに解析し、その後 JSON としてフォーマットする。 パイプライン
TOML から JSON へ変換
TOML 設定ファイルを JSON 入力を期待するツールや API のために解析する。 パイプライン
TOML から JSON を経て CSV へ変換
TOML を JSON に変換し、その後データエクスポートのために CSV に変換する。 パイプライン
TOML から JSON を経て YAML へ変換
TOML 設定を JSON 経由で YAML に変換し、Kubernetes や CI ツールに適用する。 パイプライン
JSON 経由で TOML から YAML へ変換
TOML 設定ファイルを YAML 形式に変換し、JSON を中間表現として使用する。 パイプライン
ネストされた URL パラメータのデコード(Base64 JSON)
URL エンコード Base64 JSON を運ぶ URL パラメータを可読なフォーマット済み JSON に展開する。 パイプライン
YAML から TypeScript インターフェースを生成
YAML ドキュメントを TypeScript インターフェース定義に変換し、JSON を中間フォーマットとして使用する。 パイプライン