Environment Variables 環境變數是什麼？藏秘密的保險箱檔案

把 API 金鑰直接寫在程式碼裡，是新手最常犯、代價也最貴的錯。程式碼一旦上傳到公開平台，所有人都看得到你的秘密。

解法很成熟：把秘密寫在一個叫 .env 的隱藏檔案裡，讓程式去讀。這一招學會，你的專案就從危險變安全。

定義

環境變數是一組鍵值對，在程式執行時由系統提供給應用程式使用。它可以根據不同環境設定不同的值，開發一組、測試一組、正式一組，程式碼本身完全不用改。

實務上會把這些鍵值對寫在專案根目錄的 .env 檔案裡，例如 AI 服務金鑰、資料庫連線字串、加密金鑰、郵件服務金鑰與專案網址。

一句話記住原則：程式碼可以公開，你的秘密不要公開。

白話比喻

把它想成藏秘密的保險箱檔案。房子可以帶人參觀，保險箱不打開。程式碼是房子，.env 是保險箱。

錯誤示範是把金鑰與密碼直接寫在程式檔案裡，這叫 Hardcoding。程式碼一旦上傳到公開平台，所有人都看得到你的秘密，別人可以拿你的金鑰去用，帳單卻算在你頭上。

寫死在程式碼跟放在 .env 差在哪？

實際用例

最佳實踐有五條：絕不把秘密寫在程式碼裡、使用 .env 存放敏感資訊、把 .env 加進 .gitignore 避免被上傳、不同環境使用不同設定、定期更換金鑰與秘密降低風險。

讀取方式依語言而異。Node 生態安裝 dotenv 套件後載入，再從執行環境取值；Python 安裝 python-dotenv 後載入，再用取環境變數的方式讀出來。兩邊的概念完全一樣。

你保管的通常是 API Key 這類長期有效的憑證，一旦外流別人就能直接用。所以「不要寫進程式碼」不是講究，是底線。