資料與 API詞條 1-51

環境變數Environment Variable

也常叫做:環境變數檔、Environment Variable、.env

你可能會這樣說

API 金鑰不想寫在程式碼裡被看到——聽說可以放進「環境變數」,程式執行時再自己去讀。

白話解釋

環境變數是存在程式碼外面、讓程式執行時讀取的設定值,像 API 金鑰、資料庫密碼、正式或測試模式的開關。

像把鑰匙放在門口的鎖盒,而不是隨身抄一份——程式碼可以大方分享,機密留在鎖盒裡。慣例上寫在 .env 檔案,而且一定要把它排除在版控之外。

換環境就換一套變數:本機用測試金鑰、正式站用真的,程式碼一行都不用改。跟 AI 說「機密用環境變數管理」,它會把整套做好。

親手試試

模式=開發
金鑰=測試用金鑰
資料庫=本機的假資料
模式=測試
金鑰=沙箱金鑰
資料庫=雲端測試庫
模式=正式
金鑰=真的金鑰(機密!)
資料庫=正式資料庫

同一支程式,換環境就換一套設定——程式碼一行都不用改。

圖 1-51 點分頁:三種環境各讀各的設定值,程式本身不動。

這樣對 AI 說

中文就可以
請幫我導入環境變數來管理機密設定:
1. 建立 .env 檔,放入 API 金鑰和模式切換。
2. 程式改成從環境變數讀取,並附上範本檔 .env.example。
3. 確保 .env 不會被推上 Git。
4. 教我部署到正式環境時怎麼設定這些值。

同一課的其他詞