JSON から .env への変換ツール

.env ファイルとは？

// Generate .env lines from a JSON object in Node.js
const config = {
  DATABASE_URL: 'postgres://user:pass@localhost:5432/mydb',
  PORT: 8080,
  DEBUG: true,
  NOTE: 'value with spaces',
};

const needsQuotes = (s) => /[\s#"'\n]/.test(s);

const env = Object.entries(config)
  .map(([key, value]) => {
    if (typeof value === 'string') {
      return needsQuotes(value)
        ? `${key}=${JSON.stringify(value)}`
        : `${key}=${value}`;
    }
    return `${key}=${value ?? ''}`; // null -> empty value
  })
  .join('\n');

console.log(env);
// DATABASE_URL=postgres://user:pass@localhost:5432/mydb
// PORT=8080
// DEBUG=true
// NOTE="value with spaces"

主な機能

例

{
  "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
  "PORT": 8080,
  "DEBUG": true,
  "LOG_LEVEL": "info",
  "API_KEY": "sk_live_abc123"
}

DATABASE_URL=postgres://user:pass@localhost:5432/mydb
PORT=8080
DEBUG=true
LOG_LEVEL=info
API_KEY=sk_live_abc123

{
  "GREETING": "Hello, World",
  "MOTD": "line one\nline two",
  "COLOR": "#ff0000",
  "NOTE": "value with # hash",
  "EMPTY": null
}

GREETING="Hello, World"
MOTD="line one\nline two"
COLOR="#ff0000"
NOTE="value with # hash"
EMPTY=

{
  "databaseUrl": "postgres://localhost/mydb",
  "poolSize": 10,
  "enable-signup": true
}

DATABASE_URL=postgres://localhost/mydb
POOL_SIZE=10
ENABLE_SIGNUP=true

{
  "APP_NAME": "my-app",
  "FEATURES": { "signup": true, "beta": false },
  "REGIONS": ["us-east-1", "eu-west-1"]
}

APP_NAME=my-app
FEATURES="{\"signup\":true,\"beta\":false}"
REGIONS="[\"us-east-1\",\"eu-west-1\"]"

使い方

1. 1

   JSON オブジェクトを貼り付ける

   上の入力欄にフラットな JSON オブジェクトを入力または貼り付けてください。「例を読み込む」をクリックして、設定オブジェクト、引用符が必要な値、ネストしたオブジェクトを試すこともできます。

2. 2

   ライブの .env 出力を確認

   .env ファイルが出力パネルに即座に表示されます。UPPER_SNAKE_CASE の名前にするには「キーを正規化」を、ファイルをシェルで source する場合は「export プレフィックスを追加」を切り替えてください。

3. 3

   コピーまたはダウンロード

   「コピー」で .env をクリップボードに取得するか、「ダウンロード」で .env ファイルとして保存してください。プロジェクトにそのまま入れて dotenv で読み込む準備が整います。

よくある JSON の落とし穴

["a", "b", "c"]

{"ITEMS": "a,b,c"}

{'PORT': 8080,}

{"PORT": 8080}

{"DB": {"host": "localhost", "port": 5432}}

{"DB_HOST": "localhost", "DB_PORT": 5432}

{"2fa-enabled": true}

{"TWO_FA_ENABLED": true}

{"MSG": Hello World}

{"MSG": "Hello World"}

よくある使用例

設定エクスポートから .env を生成

API、設定ダッシュボード、シークレットマネージャーからの JSON 設定エクスポートを、ローカル開発やコンテナですぐ使える .env ファイルに変えます。

.env テンプレートの雛形を作成

新しいサービスが必要とする変数を記述する JSON オブジェクトを作り、.env に変換し、.env.example をコミットすれば、チームメンバーはどのキーを埋めるべきか正確に分かります。

JSON 設定のツールを dotenv に橋渡し

一部のツールは設定を JSON で出力しますが、実行環境は .env を期待します。JSON 出力を dotenv 形式に変換し、パイプラインの両側が同じ変数で一致するようにします。

source 可能なシェル env ファイルを生成

export プレフィックスを有効にして、シェルや CI ステップで直接 source できるファイルを生成し、JSON 設定ブロブを 1 回の貼り付けでエクスポートされた環境変数に変えます。

設定を往復させる

これを .env から JSON への変換ツールと組み合わせ、設定を構造化された JSON として編集してから .env に書き戻します。往復で安全な引用により、値が両方向で維持されることが保証されます。

大文字小文字の混在したキーを正規化

「キーを正規化」オプションで、camelCase や kebab-case のキーを持つ JSON オブジェクトを、環境変数の慣例に合った一貫した UPPER_SNAKE_CASE 変数名の .env に変換します。

技術的な詳細

オブジェクト専用の入力と型付きシリアライズ

入力はブラウザのネイティブな JSON.parse() で解析され、トップレベルのオブジェクトでなければなりません。配列やスカラーは明確なエラーで拒否されます。各トップレベルのプロパティは型ごとにシリアライズされます。数値とブール値は裸で書かれ、null は空の値（KEY=）になり、文字列はスペース、改行、#、引用符を含む場合を除いてそのまま書かれます。その場合は往復の安全のため二重引用符で囲まれてエスケープされます。

ネスト値とキーの正規化

ネストしたオブジェクトや配列はコンパクトな JSON.stringify でシリアライズされ、二重引用符で囲まれてエスケープされ、フラット化されたキーを名指しする警告が出ます。任意の「キーを正規化」ステップはキーを UPPER_SNAKE_CASE に変換し、ほとんどの無効な名前を解決します。キーをそのまま保つ場合、[A-Za-z_][A-Za-z0-9_]* に一致しないキーは無効名の警告をトリガーします。任意の export プレフィックスを各行に追加できます。

ブラウザベース — アップロードもサーバーもなし

すべての処理はブラウザの JavaScript エンジン内のみで行われ、JSON データがネットワークを介して送信されることはありません。Node の dotenv ライブラリはブラウザでは安全に動かないため、シリアライザーは外部依存なしで自前で書かれています。200KB を超える入力は、ブラウザの応答性を保つためライブモードから手動モード（明示的な「変換」クリック）に切り替わります。

ベストプラクティス

env 慣例が必要でない限りキーはそのまま保つ

消費するアプリがすでに JSON 内の正確なキー名を期待している場合は「キーを正規化」をオフのままにし、何も予期せずリネームされないようにしてください。環境変数が慣例的に使う UPPER_SNAKE_CASE を特に望むときだけオンにしてください。

ネストは偶然ではなく意図的にフラット化する

ネスト値は .env 内で不透明な JSON 文字列になり、ほとんどのアプリは自動的に解析し直せません。フラット化の警告を見たら、変換前に JSON をフラットでプレフィックス付きのキー（DB_HOST、DB_PORT）に再構成するか、YAML のような構造化形式を選ぶことをおすすめします。

往復のために自動引用を信頼する

いつ引用するかはツールに任せてください。必要な値だけを二重引用符で囲んでエスケープします。これにより .env を読みやすく保ちつつ、スペース、改行、# を含む値が .env から JSON への変換ツールを通じた往復で変わらず維持されることを保証します。

シークレットはブラウザ専用ツールでのみ生成する

ここで変換する JSON は事実上認証情報の集合です。完全にブラウザ内で動作するツールでのみ .env を生成してください。DevTools でネットワークリクエストがゼロであることを確認してください。本変換ツールはこれに該当し、サーバー側や API ベースのジェネレーターとは違います。

まず JSON 入力を検証する

JSON が手書きやスクリプトで組み立てられている場合は、まず JSON フォーマッター で検証して末尾のカンマや引用符なしのキーを捕捉してください。そうすれば分かりにくい解析エラーではなく、きれいな .env が得られます。

よくある質問