使用 Vue & UI Pro 的仪表板模板

.env

.env 文件指定了您的构建/开发时环境变量。

此文件应添加到您的 .gitignore 文件中,以避免将机密信息推送到您的存储库。

开发、构建和生成时间

Nuxt CLI 在开发模式下以及运行 nuxi buildnuxi generate 时内置了 dotenv 支持。

除了任何进程环境变量之外,如果您在项目根目录中有一个 .env 文件,它将被自动加载 **在开发、构建和生成时**。在那里设置的任何环境变量都可以在您的 nuxt.config 文件和模块中访问。

.env
MY_ENV_VARIABLE=hello
请注意,从 .env 中删除变量或完全删除 .env 文件不会取消设置已经设置的值。

自定义文件

如果您想使用不同的文件 - 例如,使用 .env.local.env.production - 您可以在使用 nuxi 时通过传递 --dotenv 标志来实现。

终端
npx nuxi dev --dotenv .env.local

在开发模式下更新 .env 时,Nuxt 实例会自动重启以将新值应用到 process.env

生产预览

**服务器构建完成后**,您需要在运行服务器时设置环境变量。

此时不会读取您的 .env 文件。您如何做到这一点因环境而异。

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

或者,您可以使用终端将环境变量作为参数传递。例如,在 Linux 或 macOS 上

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

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

文档 > 指南 > 进一步 > 运行时配置 中了解更多信息。
如果您想使用构建时设置的环境变量,但并不关心以后更新这些变量(或者只需要在您的应用程序中 响应式地更新它们),那么appConfig 可能是一个更好的选择。您可以在您的nuxt.config(使用环境变量)和项目中的~/app.config.ts 文件中定义appConfig
文档 > 指南 > 目录结构 > 应用配置 中了解更多信息。