环境变量

项目使用.env，.env.[mode]存放环境变量，在代码中通过import.meta.env.VITE_XXXX的方式进行引用。环境变量文件存放在每个系统的根目录下，每个系统都有自己独立的环境变量。

提示

为了防止意外地将一些环境变量泄漏到客户端，只有以 VITE 为前缀的变量才会暴露给经过 vite 处理的代码。

.env文件

该文件用于存放公共的环境变量。

.env

# 应用名称
VITE_APP_NAME = "XXX"
# 公钥
VITE_PUBLIC_KEY = "123456"
# 私钥，不会暴露给客户端源码
PRIVATE_KEY = "654321"

.env.[mode]文件

该文件用于存放对应环境的环境变量，例如.env.production用于存放生产环境的环境变量，.env.development用于存放开发环境的环境变量，并且会覆盖.env文件中的同名变量。

.env.development

# 开发环境服务器地址
VITE_BASE_URL = "https://www.dev.com"

.env.production

# 生产环境服务器地址
VITE_BASE_URL = "https://www.prod.com"

.local文件

在本地开发的时候，可能需要修改一些环境变量。不建议直接修改.env和.env.[mode]中的变量，避免出现意外提交到线上环境的情况。推荐在本地新建一个.local文件，用于存放本地开发时需要修改的环境变量，该文件中的变量将会覆盖对应的.env和.env.[mode]中的同名变量，并且不会被 git 检入。

.env.development.local

# 本地开发服务器地址
VITE_BASE_URL = "https://localhost"
# 本地开发测试账号
VITE_USER_NAME = 'admin'
# 本地开发测试密码
VITE_PASS_WORD = 'admin@123'

注意

为了方便本地开发，避免重复输入账号密码，登录页面会读取VITE_USER_NAME和VITE_PASS_WORD两个环境变量的值，自动填充到输入框中。请不要在.local文件之外定义VITE_USER_NAME和VITE_PASS_WORD两个环境变量，避免线上环境出现自动填充账号密码的情况。