dotenv

dotenv は .env ファイルを環境変数へ読み込むライブラリおよび規約であり、Node.js エコシステムで最も広く使われ、設定を外部化する。

目的

ローカル開発では .env ファイルで設定を管理し、本番では実際の環境変数を使うことで、コードを変更せずに済むようにする。

メカニズム

起動時に .env ファイルを読み、KEY=VALUE 行を解析して process.env へ注入する。複数環境（.env.development）、変数補間（$VAR）、引用符処理に対応する。既存の環境変数は上書きしない（override 指定時を除く）。

ユースケース

Node.js プロジェクトのローカル設定
Next.js/Vite の環境変数
Docker Compose での env_file 連携
テスト環境の分離

例

入力

.env: API_KEY=secret

Output

process.env.API_KEY="secret"

Loaded into the environment

よくあるエラー

Loading dotenv in production wastes startup time: Use real environment variables in production and do not load .env

関連用語

ENV ファイルは KEY=VALUE 形式でアプリケーション設定用の環境変数を定義する。12-Factor アプリの推奨方式である。

INI は伝統的な設定ファイル形式である。[section] ヘッダーと key=value ペアで設定をグループ化する。シンプルだが標準化されておらず、実装ごとに細部が異なる。

JavaのPropertiesファイルは KEY=VALUE または KEY:VALUE 形式の設定ファイルで、Javaエコシステムの伝統的な設定形式であり、Unicodeエスケープをサポートする。

関連ツール

ENV パーサー

.env 形式の KEY=VALUE 行を JSON に解析します。空行と「#」で始まるコメントはスキップされます。それ以外の dotenv 規約は未実装で、「export 」プレフィックスはキー名に残り（export PORT=3000 → “export PORT”）、値を囲む引用符もそのまま保持されます。

ENV 文字列生成

ENV Stringify — 純クライアントサイドツール。プライバシーファースト、サーバー往復なし。

JSON から ENV への変換

Json To Env — 純クライアントサイドツール。プライバシーファースト、サーバー往復なし。

YAML から ENV への変換

Yaml To Env — 純クライアントサイドツール。プライバシーファースト、サーバー往復なし。

References