.env ファイルパーサー

入力例

# データベース設定
DB_HOST=localhost
DB_PORT=5432
DB_NAME=myapp
DB_PASSWORD="s3cr3t"
# API キー
API_KEY=
STRIPE_KEY=your-stripe-key
# 重複キーの例
APP_ENV=development
APP_ENV=production

パーサーは DB_PASSWORD の引用符を外し、API_KEY に「値が空です」、2 つ目の APP_ENV に「キーが重複しています」を表示し、ステータスは「有効 6 件、警告 2 件。」になります。エクスポートした env.json の APP_ENV は最後の値です。

{
  "DB_HOST": "localhost",
  "DB_PORT": "5432",
  "DB_NAME": "myapp",
  "DB_PASSWORD": "s3cr3t",
  "API_KEY": "",
  "STRIPE_KEY": "your-stripe-key",
  "APP_ENV": "production"
}

コロン・空白・そのほかのキー名

dotenv は YAML 風の KEY: value も読みますが、コロンの後に空白が必要です。dotenv が読み飛ばす行はテーブルでエラーになりエクスポートされません。dotenv が受け付けるものの珍しいキーは警告になり、エクスポートされます。

APP_NAME: 予約システム
export API_URL: https://api.example.jp/v2
SMTP HOST=smtp.example.jp
mail.from=info@example.jp
PORT:8080

{
  "APP_NAME": "予約システム",
  "API_URL": "https://api.example.jp/v2",
  "mail.from": "info@example.jp"
}

ステータスは「有効 2 件、警告 1 件、エラー 2 件。」です。3 行目はキーに空白があり、dotenv のキーのパターン [\w.-]+ に合わないのでエラー、5 行目はコロンの後に空白がありません。キーに全角スペース（U+3000）が入った場合も同じくエラーになります。 Node.js 自身のパーサー（—env-file、util.parseEnv()）はルールが異なり、Node.js 22.23.3 ではこのテキストから SMTP HOST と mail.from を読み、コロンの 3 行はすべて無視します。

proto という名前のキーだけは、エクスポートが dotenv.parse() と異なります。dotenv はこのキーを取り除きます。

__proto__=keep
A=1

{
  "__proto__": "keep",
  "A": "1"
}

検出される一般的な .env の問題

• = 記号がない——= もコロンもなく、キーと値のペアとして解析できない行。
• コロンの書き方——PORT:8080 や PORT : 8080 は dotenv が読み飛ばします。PORT=8080 か PORT: 8080 と書いてください。
• 空の値——キーは存在するが値が空。アプリによっては実行時エラーになる可能性があります。
• 重複キー——同じキーが複数回出現。dotenv は最後の値を使いますが、ほかのローダーも同じとは限りません。
• 一般的でないキー名——キー名は英字かアンダースコアで始め、英数字とアンダースコアだけにするのが無難です。.・- を含むキーや数字で始まるキーは dotenv でも読み込まれます（警告）。空白などを含むキーは読み込まれません（エラー）。
• 引用符なしの値に # がある——dotenv はそこからコメントとみなすので、COLOR=#fff は空になり、URL=https://example.com/#top は #top が消えます。値を引用符で囲んでください。ルールは dotenv の解析ルールを参照。

制限

• 変数は展開しません。${HOME}/data はそのまま残ります。dotenv-expand、Docker Compose、一部のフレームワークはこうした参照を展開します。
• dotenv のルールだけです。Node.js の —env-file、Docker Compose の env_file、Python の python-dotenv、シェルの source は、引用符・コロン・export・# の扱いがそれぞれ異なります。実際に使うローダーで確認してください。
• 値は平文で表示されます。テーブルはシークレットを隠さないので画面共有に注意してください。ファイルを共有する前に APIキーマスキングで値を置き換えられます。