From ff70bcea2122991fcf1b71955156bdfb216ec047 Mon Sep 17 00:00:00 2001
From: Jun Shindo <46585162+jay-es@users.noreply.github.com>
Date: Thu, 16 Oct 2025 20:00:36 +0900
Subject: [PATCH] docs: add note that bun's env loading behavior interferes
 with Vite's one

---
 guide/env-and-mode.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/guide/env-and-mode.md b/guide/env-and-mode.md
index 353d6b2b..364170d1 100644
--- a/guide/env-and-mode.md
+++ b/guide/env-and-mode.md
@@ -74,6 +74,12 @@ Vite は特定のモードの `.env.[mode]` ファイルに加えて、常に `.
 
 :::
 
+:::warning Bun ユーザー
+
+[Bun](https://bun.sh) を使用する際、Bun はスクリプトの実行前に `.env` ファイルを自動的に読み込むことに注意してください。この組み込み動作により、環境変数が直接 `process.env` に読み込まれ、既存の `process.env` の値を尊重する Vite の機能に干渉する可能性があります。回避策については [oven-sh/bun#5515](https://github.com/oven-sh/bun/issues/5515) を参照してください。
+
+:::
+
 また、Vite は [dotenv-expand](https://github.com/motdotla/dotenv-expand) を使って、設定不要で env ファイルに書かれた変数を展開できます。構文の詳細については、[ドキュメント](https://github.com/motdotla/dotenv-expand#what-rules-does-the-expansion-engine-follow)を参照してください。
 
 環境値の中で `$` を使用する場合は、`\` でエスケープする必要があることに注意してください。