macOS での NODE_ENV 設定方法

macOSでNODE_ENVをproduction/developmentに設定する方法

日本語解説

macOSでJavaScriptやNode.jsの開発環境を設定する際、NODE_ENV環境変数をproductionまたはdevelopmentに設定することは、アプリケーションの挙動を最適化するために重要です。

ターミナルを使用する方法:

• 環境変数を設定
  以下のコマンドを実行して、NODE_ENVを希望のモードに設定します。
• ターミナルを開く
  macOSのターミナルアプリケーションを起動します。

export NODE_ENV=production  # productionモードに設定
export NODE_ENV=development  # developmentモードに設定

• 設定を確認
  設定が反映されていることを確認するために、次のように入力します。

echo $NODE_ENV

シェルスクリプトを使用する方法:

• 環境変数を設定
  スクリプトに以下の行を追加します。
• シェルスクリプトを作成
  .zshrcや.bashrcなどのシェルスクリプトを作成または編集します。

export NODE_ENV=production  # productionモードに設定
export NODE_ENV=development  # developmentモードに設定

• スクリプトを再読み込み
  ターミナルで次のコマンドを実行して、スクリプトの変更を反映します。

source ~/.zshrc  # または ~/.bashrc

Node.jsアプリケーション内で設定する方法:

• アプリケーションコード内に設定
  アプリケーションの入口点（通常はindex.jsなど）で、process.env.NODE_ENVを設定します。

if (process.env.NODE_ENV !== 'production') {
  // developmentモードの処理
} else {
  // productionモードの処理
}

パッケージマネージャー（npm、yarn）を使用する方法:

• package.jsonファイル
  package.jsonファイルのscriptsセクションに、NODE_ENVを設定するスクリプトを定義します。

{
  "scripts": {
    "start:dev": "NODE_ENV=development node index.js",
    "start:prod": "NODE_ENV=production node index.js"
  }
}

• スクリプトを実行
  ターミナルで、以下のようにスクリプトを実行します。

npm run start:dev  # developmentモード
npm run start:prod  # productionモード

注意

• 一般的には、NODE_ENVはproductionモードで本番環境にデプロイし、developmentモードでローカル開発やテスト環境で使用します。
• NODE_ENVをdevelopmentモードに設定すると、デバッグや開発作業が容易になります。
• NODE_ENVをproductionモードに設定すると、アプリケーションは最適化され、パフォーマンスが向上します。

macOSでのNODE_ENV設定方法のコード例

ターミナルでの設定:

# productionモードに設定
export NODE_ENV=production

# developmentモードに設定
export NODE_ENV=development

シェルスクリプトでの設定:

# .zshrcまたは.bashrcファイルに追記
export NODE_ENV=production  # または development

// index.jsなど
if (process.env.NODE_ENV !== 'production') {
  // developmentモードの処理
  console.log('Development mode');
} else {
  // productionモードの処理
  console.log('Production mode');
}

// package.jsonファイル
{
  "scripts": {
    "start:dev": "NODE_ENV=development node index.js",
    "start:prod": "NODE_ENV=production node index.js"
  }
}

実行方法

npm run start:dev  # developmentモード
npm run start:prod  # productionモード

解説

• パッケージマネージャーでの設定
  package.jsonファイルのscriptsセクションにスクリプトを定義し、npmまたはyarnで実行します。
• Node.jsアプリケーション内での設定
  アプリケーションのコード内でprocess.env.NODE_ENVをチェックして、モードに応じた処理を行います。
• シェルスクリプトでの設定
  シェルスクリプトに設定を記述し、ターミナルでスクリプトを実行します。
• ターミナルでの設定
  直接ターミナルで環境変数を設定します。

dotenvパッケージを使用する:

• 環境変数を設定
  .envファイルに以下のように環境変数を設定します。
• .envファイルの作成
  プロジェクトのルートディレクトリに.envファイルを作成します。
• dotenvパッケージのインストール
  npm install dotenvまたはyarn add dotenvでdotenvパッケージをインストールします。

NODE_ENV=production  # または development

• アプリケーション内で読み込む
  アプリケーションのコード内でdotenvパッケージを読み込み、環境変数を取得します。

require('dotenv').config();
console.log(process.env.NODE_ENV);

• スクリプトの定義
  package.jsonファイルのscriptsセクションに、cross-envを使用して環境変数を設定するスクリプトを定義します。

{
  "scripts": {
    "start:dev": "cross-env NODE_ENV=development node index.js",
    "start:prod": "cross-env NODE_ENV=production node index.js"
  }
}

npm run start:dev  # developmentモード
npm run start:prod  # productionモード

環境変数マネージャーを使用する:

• 環境変数マネージャーのインストール
  macOS用の環境変数マネージャー（例えば、LaunchControl、Keychain Access）をインストールします。

• 環境変数マネージャー
  macOSのシステムレベルで環境変数を管理することができます。
• cross-envパッケージ
  ターミナルで環境変数を設定し、スクリプトを実行する際に使用できます。
• dotenvパッケージ
  .envファイルを使用して環境変数を管理し、アプリケーション内で読み込むことができます。