.gitignore 文件中,以避免将秘密推送到您的仓库。Nuxt CLI 在开发模式以及运行 nuxt build 和 nuxt generate 时内置了对 dotenv 的支持。
除了任何进程环境变量外,如果在项目根目录中有 .env 文件,它将在 开发、构建和生成时 自动加载。此处设置的任何环境变量都可以在 nuxt.config 文件和模块中访问。
MY_ENV_VARIABLE=hello
.env 中删除变量或完全删除 .env 文件,不会取消已设置的值。如果想使用不同的文件——例如 .env.local 或 .env.production——可以在使用 Nuxt CLI 时传入 --dotenv 参数来实现。
npx nuxt dev --dotenv .env.local
开发模式下更新 .env 文件时,Nuxt 实例会自动重启,以将新值应用到 process.env。
服务器构建完成后,您需在运行服务器时自行设置环境变量。
此时不会读取 .env 文件。如何设置取决于不同的环境。
此设计决定确保兼容各种部署环境,其中一些可能没有传统的文件系统,如无服务器平台或像 Cloudflare Workers 这样的边缘网络。
由于生产环境不使用 .env 文件,您必须通过托管环境提供的工具和方法显式设置环境变量。常见方式包括:
$ DATABASE_HOST=mydatabaseconnectionstring node .output/server/index.mjs.bashrc 或 .profile 中设置环境变量。runtimeConfig在生产环境中不会获取不以 NUXT_ 开头的环境变量。用于本地生产预览,我们推荐使用 nuxt preview,因为使用此命令时,.env 文件将方便地加载到 process.env 中。请注意,此命令要求在包目录中安装依赖。
或者也可以使用终端通过参数传递环境变量。例如,在 Linux 或 macOS 上:
DATABASE_HOST=mydatabaseconnectionstring node .output/server/index.mjs
请注意,对于纯静态站点,在项目预渲染完成后,无法设置运行时配置。