feat():learning后台管理前端页面初始化
This commit is contained in:
78
README_ENV.md
Normal file
78
README_ENV.md
Normal file
@@ -0,0 +1,78 @@
|
||||
# 环境变量配置
|
||||
|
||||
## 配置说明
|
||||
|
||||
项目支持通过环境变量配置,支持不同环境的部署需求。参考 `goalfymax-front` 项目的环境变量配置方式。
|
||||
|
||||
## 环境变量文件
|
||||
|
||||
### 开发环境
|
||||
创建 `.env.development` 文件:
|
||||
```bash
|
||||
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` 文件:
|
||||
```bash
|
||||
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` 文件:
|
||||
```bash
|
||||
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. 复制环境变量模板
|
||||
```bash
|
||||
cp env.example .env.development
|
||||
```
|
||||
|
||||
### 2. 修改配置
|
||||
编辑对应的环境变量文件,设置正确的配置值。
|
||||
|
||||
### 3. 启动项目
|
||||
```bash
|
||||
# 开发环境
|
||||
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 地址。
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. 环境变量文件需要以 `.env` 开头
|
||||
2. 变量名必须以 `VITE_` 开头才能在客户端代码中使用
|
||||
3. 生产环境构建时,环境变量会被编译到代码中
|
||||
4. 敏感信息不要放在环境变量中,应该通过后端配置
|
||||
5. 开发环境使用代理,生产环境直接使用环境变量中的 API 地址
|
||||
Reference in New Issue
Block a user