From 4a9ab82a42631a10e9642a7f45cd4e1e5bd221e5 Mon Sep 17 00:00:00 2001 From: TAKAHASHI Shuuji Date: Fri, 29 Nov 2024 13:02:08 +0900 Subject: [PATCH] docs: clarify .env loading precedence / behavior MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit resolve #1759 https://github.com/vitejs/vite/commit/e4a0ff112b17150a5ffd97736fbeb372038a1589 の反映です。 --- guide/env-and-mode.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/guide/env-and-mode.md b/guide/env-and-mode.md index bf58cca3..b5a6b5d5 100644 --- a/guide/env-and-mode.md +++ b/guide/env-and-mode.md @@ -29,6 +29,8 @@ Vite は、[環境ディレクトリー](/config/shared-options.md#envdir)にあ 特定のモードの env ファイル（例: `.env.production`）は、汎用の env ファイル（例: `.env`）よりも優先されます。 +Vite は特定のモードの `.env.[mode]` ファイルに加えて、常に `.env` と `.env.local` を読み込みます。特定のモードのファイルで宣言された変数は汎用のファイル内の変数より優先されますが、`.env` または `.env.local` でのみ定義された変数は、引き続き環境で利用できます。 + また、Vite の実行時に既に存在している環境変数は最も優先度が高く、`.env` ファイルによって上書きされることはありません。例えば、`VITE_SOME_KEY=123 vite build` を実行する場合。 `.env` は Vite 起動時に読み込まれます。変更した後はサーバーを再起動してください。