.env

.env 文件指定了你的构建/开发时环境变量。
此文件应添加到你的 .gitignore 文件中，以避免将秘密信息推送到你的仓库。

开发、构建和生成时

Nuxt CLI 在开发模式和运行 nuxt build 和 nuxt generate 时，内置了dotenv支持。

除了任何进程环境变量，如果你的项目根目录中有 .env 文件，它将在开发、构建和生成时自动加载。其中设置的任何环境变量都可以在你的 nuxt.config 文件和模块中访问。

.env
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
  • 你可以在 shell 配置文件中设置环境变量，例如 .bashrc 或 .profile。
  • 许多云服务提供商，如 Vercel、Netlify 和 AWS，都提供通过其仪表板、CLI 工具或配置文件设置环境变量的界面。
runtimeConfig不会拾取在生产环境中不以 NUXT_ 开头的环境变量 (https://nuxtjs.org.cn/docs/4.x/guide/going-further/runtime-config#environment-variables).

生产预览

出于本地生产预览目的，我们建议使用 nuxt preview，因为使用此命令，.env 文件将方便地加载到 process.env 中。请注意，此命令需要将依赖项安装在包目录中。

或者你可以通过终端将环境变量作为参数传递。例如，在 Linux 或 macOS 上

终端
DATABASE_HOST=mydatabaseconnectionstring node .output/server/index.mjs

请注意，对于纯静态站点，在项目预渲染后无法设置运行时配置。

在文档 > 4 X > 指南 > 深入 > 运行时配置中阅读更多内容。
如果你想使用在构建时设置的环境变量，但不需要在后期更新它们（或者只需要在你的应用程序中反应式地更新它们），那么 appConfig 可能是更好的选择。你可以在 nuxt.config 中（使用环境变量）和项目中的 ~/app.config.ts 文件中定义 appConfig。
在 文档 > 4 X > 指南 > 目录结构 > 应用程序 > 应用程序配置 中阅读更多内容。