1.9 KiB
1.9 KiB
环境变量配置
配置说明
项目支持通过环境变量配置,支持不同环境的部署需求。参考 goalfymax-front 项目的环境变量配置方式。
环境变量文件
开发环境
创建 .env.development 文件:
VITE_API_BASE_URL=http://localhost:8084
VITE_APP_TITLE=GoalfyMax Admin
VITE_APP_VERSION=1.0.0
VITE_ENABLE_DEVTOOLS=true
VITE_USE_MOCK=false
生产环境
创建 .env.production 文件:
VITE_API_BASE_URL=https://your-production-api.com
VITE_APP_TITLE=GoalfyMax Admin
VITE_APP_VERSION=1.0.0
VITE_ENABLE_DEVTOOLS=false
VITE_USE_MOCK=false
测试环境
创建 .env.test 文件:
VITE_API_BASE_URL=https://your-test-api.com
VITE_APP_TITLE=GoalfyMax Admin
VITE_APP_VERSION=1.0.0
VITE_ENABLE_DEVTOOLS=true
VITE_USE_MOCK=false
使用方法
1. 复制环境变量模板
cp env.example .env.development
2. 修改配置
编辑对应的环境变量文件,设置正确的配置值。
3. 启动项目
# 开发环境
npm run dev
# 生产环境构建
npm run build
环境变量说明
| 变量名 | 说明 | 默认值 |
|---|---|---|
VITE_API_BASE_URL |
API 基础地址 | http://localhost:8084 |
VITE_APP_TITLE |
应用标题 | GoalfyMax Admin |
VITE_APP_VERSION |
应用版本 | 1.0.0 |
VITE_ENABLE_DEVTOOLS |
启用开发工具 | true |
VITE_USE_MOCK |
使用 Mock 数据 | false |
代理配置
开发环境下,Vite 会自动代理 /api 请求到 VITE_API_BASE_URL,无需在代码中硬编码 API 地址。
注意事项
- 环境变量文件需要以
.env开头 - 变量名必须以
VITE_开头才能在客户端代码中使用 - 生产环境构建时,环境变量会被编译到代码中
- 敏感信息不要放在环境变量中,应该通过后端配置
- 开发环境使用代理,生产环境直接使用环境变量中的 API 地址