feat: 初始化web项目,接口创建种子用户
This commit is contained in:
110
apps/web/ENV.md
Normal file
110
apps/web/ENV.md
Normal file
@@ -0,0 +1,110 @@
|
||||
# 环境变量配置说明
|
||||
|
||||
本项目使用 Vite 的环境变量系统来管理不同环境的配置。
|
||||
|
||||
## 环境变量文件
|
||||
|
||||
### `.env`
|
||||
默认环境变量文件,所有环境都会加载。通常包含本地开发的默认配置。
|
||||
|
||||
### `.env.development`
|
||||
开发环境配置,运行 `pnpm dev` 时会自动加载。
|
||||
|
||||
### `.env.production`
|
||||
生产环境配置,运行 `pnpm build` 时会自动加载。
|
||||
|
||||
### `.env.local`
|
||||
本地环境变量文件(**不会被 git 跟踪**),用于覆盖默认配置。
|
||||
- 复制 `.env.local.example` 为 `.env.local` 并根据需要修改
|
||||
- 此文件优先级最高,会覆盖其他环境变量文件中的同名变量
|
||||
|
||||
## 环境变量列表
|
||||
|
||||
| 变量名 | 说明 | 默认值 | 示例 |
|
||||
|--------|------|--------|------|
|
||||
| `VITE_PORT` | 开发服务器端口 | `5173` | `5173` |
|
||||
| `VITE_API_BASE_URL` | API 基础地址 | `http://localhost:3200/api` | `https://api.example.com/api` |
|
||||
| `VITE_APP_NAME` | 应用名称 | `投小记` | `投小记` |
|
||||
| `VITE_APP_TITLE` | 应用标题 | `投小记 - 投资决策与复盘工具` | - |
|
||||
| `VITE_ENV` | 环境标识 | `development` | `production` |
|
||||
| `VITE_USE_MOCK` | 是否启用 Mock 数据 | `false` | `true` |
|
||||
| `VITE_DEBUG` | 是否显示调试信息 | `true` (开发) / `false` (生产) | `true` |
|
||||
|
||||
## 使用方法
|
||||
|
||||
### 1. 在代码中使用环境变量
|
||||
|
||||
```typescript
|
||||
// 方式1:使用配置对象(推荐)
|
||||
import { envConfig } from '@/config/env'
|
||||
|
||||
const apiUrl = envConfig.apiBaseUrl
|
||||
const appName = envConfig.appName
|
||||
|
||||
// 方式2:直接使用 import.meta.env(不推荐,缺少类型提示)
|
||||
const apiUrl = import.meta.env.VITE_API_BASE_URL
|
||||
```
|
||||
|
||||
### 2. 在 API 服务中使用
|
||||
|
||||
```typescript
|
||||
import { api } from '@/services/api'
|
||||
|
||||
// 使用配置好的 API 客户端
|
||||
const data = await api.get('/users')
|
||||
```
|
||||
|
||||
### 3. 修改环境变量
|
||||
|
||||
#### 开发环境
|
||||
编辑 `.env.development` 文件
|
||||
|
||||
#### 生产环境
|
||||
编辑 `.env.production` 文件,或在部署平台设置环境变量
|
||||
|
||||
#### 本地个性化配置
|
||||
1. 复制 `.env.local.example` 为 `.env.local`
|
||||
2. 在 `.env.local` 中修改需要的变量
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **变量命名**:所有需要在客户端代码中使用的环境变量必须以 `VITE_` 开头
|
||||
2. **类型安全**:使用 `src/config/env.ts` 中的 `envConfig` 对象可以获得类型提示
|
||||
3. **敏感信息**:不要在环境变量文件中存储敏感信息(如密钥、密码),这些应该通过后端 API 获取
|
||||
4. **Git 跟踪**:
|
||||
- `.env`、`.env.development`、`.env.production` 会被 git 跟踪
|
||||
- `.env.local`、`.env*.local` 不会被 git 跟踪(已在 .gitignore 中配置)
|
||||
|
||||
## 部署说明
|
||||
|
||||
### 开发环境
|
||||
```bash
|
||||
pnpm dev
|
||||
# 会自动加载 .env 和 .env.development
|
||||
```
|
||||
|
||||
### 生产环境
|
||||
```bash
|
||||
pnpm build
|
||||
# 会自动加载 .env 和 .env.production
|
||||
```
|
||||
|
||||
### 预览构建结果
|
||||
```bash
|
||||
pnpm preview
|
||||
# 会使用生产环境配置预览构建结果
|
||||
```
|
||||
|
||||
## 常见问题
|
||||
|
||||
### Q: 如何修改 API 地址?
|
||||
A: 修改对应环境的 `.env` 文件中的 `VITE_API_BASE_URL` 变量
|
||||
|
||||
### Q: 如何在不同端口运行?
|
||||
A: 修改 `.env.development` 中的 `VITE_PORT` 变量,或使用命令行参数:
|
||||
```bash
|
||||
VITE_PORT=3000 pnpm dev
|
||||
```
|
||||
|
||||
### Q: 环境变量修改后不生效?
|
||||
A: 重启开发服务器,环境变量只在启动时加载
|
||||
Reference in New Issue
Block a user