# 环境变量

vue3-antd-admin 是基于 vite 来进行构建的,所有的环境变量配置都是基础vite来实现和控制的。
官方文档 (opens new window)

.env                # 所有情况下都会加载
.env.local          # 所有情况下都会加载,但会被 git 忽略
.env.[mode]         # 只在指定模式下加载
.env.[mode].local   # 只在指定模式下加载,但会被 git 忽略

加载的环境变量也会通过 import.meta.env 暴露给客户端源码。

为了防止意外地将一些环境变量泄漏到客户端,只有以 VITE_ 为前缀的变量才会暴露给经过 vite 处理的代码。例如下面这个文件中:

DB_PASSWORD=foobar
VITE_SOME_KEY=123

# 构建相关

除了一些写在.env的环境变量之外,还有一些构建和部署相关的变量都是需要在vite.config.js中配置的。

你可以通过 import.meta.env.MODE 来执行判断环境,来设置不同的参数。

默认情况下,开发服务器 (dev 命令) 运行在 development (开发) 模式,而 build 以及 serve 命令则运行在 production (生产) 模式。

你可能希望有一个 “staging” (预发布|预上线) 模式,它应该具有类似于生产的行为,但环境变量与生产环境略有不同。
你可以通过传递 --mode 选项标志来覆盖命令使用的默认模式。例如,如果你想为我们假设的 staging 模式构建应用:

vite build --mode staging

为了使应用实现预期行为,我们还需要一个 .env.staging 文件:

# .env.staging
NODE_ENV=production
VITE_APP_TITLE=My App (staging)

现在,你的 staging 应用应该具有类似于生产的行为,但显示的标题与生产环境不同。