Agentic Research

環境變數與 .env

又稱:環境變數 · API key 放哪 · .env · environment variable

給程式看的設定值,寫在程式外面,而不是寫死在程式碼裡。

你會在什麼時候遇到它

你的 API key 就是用環境變數交給工具的。放錯地方會得到「未授權」,放對地方但洩漏出去會直接燒掉你的額度。

打個比方

像飯店房卡:程式是房間,環境變數是入住時交給它的卡片。換一批客人就換卡,不用重新蓋一間房。

最小範例

# macOS / Linux
export OPENAI_API_KEY="sk-..."

# Windows PowerShell
$env:OPENAI_API_KEY = "sk-..."

# 或者放進專案目錄下的 .env 檔案
OPENAI_API_KEY=sk-...

export 只在當前這個視窗有效,關掉就沒了;.env 是寫在檔案裡,由工具自己讀。

最常搞錯的地方

  • 把 .env 提交到 git。它應該在 .gitignore 裡。已經提交過的話,那把 key 要當作已洩漏,直接作廢重發。
  • 在 A 視窗 export,卻在 B 視窗執行程式。環境變數不跨視窗。

相關詞條

下一步