跳至內容

環境變數 (env)

自 Next.js 9.4 發布以來 (Next.js 9.4),我們現在有了更直觀、更符合人體工學的新增環境變數的體驗。試試看!

注意事項:以此方式指定的環境變數將**始終**包含在 JavaScript 捆綁包中,僅在透過環境或 .env 檔案指定環境變數時,在環境變數名稱前加上 NEXT_PUBLIC_ 才會有作用。

要將環境變數新增至 JavaScript 捆綁包,請開啟 next.config.js 並新增 env 設定

next.config.js
module.exports = {
  env: {
    customKey: 'my-value',
  },
}

現在您可以在程式碼中存取 process.env.customKey。例如

function Page() {
  return <h1>The value of customKey is: {process.env.customKey}</h1>
}
 
export default Page

Next.js 會在建置時將 process.env.customKey 替換為 'my-value'。由於 webpack DefinePlugin的特性,嘗試解構 process.env 變數將無法運作。

例如,以下這一行

return <h1>The value of customKey is: {process.env.customKey}</h1>

最終會變成

return <h1>The value of customKey is: {'my-value'}</h1>