54 lines
1.5 KiB
Markdown
54 lines
1.5 KiB
Markdown
# 环境变量配置说明
|
||
|
||
## 环境变量文件
|
||
|
||
本项目使用 Vite 的环境变量功能，支持以下环境变量文件：
|
||
|
||
- `.env`：所有环境都会加载的默认变量
|
||
- `.env.development`：开发环境变量（`npm run dev` 时加载）
|
||
- `.env.production`：生产环境变量（`npm run build` 时加载）
|
||
|
||
## 已配置的环境变量
|
||
|
||
| 变量名 | 说明 | 示例值 |
|
||
|--------|------|--------|
|
||
| VITE_APP_BASE_URL | API 基础URL | https://www.quannengcha.com |
|
||
| VITE_APP_DEBUG | 调试模式 | true/false |
|
||
|
||
## 在项目中使用环境变量
|
||
|
||
### 在 Vue 组件中使用
|
||
|
||
```vue
|
||
<script setup>
|
||
// 使用 import.meta.env 访问环境变量
|
||
const baseUrl = import.meta.env.VITE_APP_BASE_URL
|
||
const isDebug = import.meta.env.VITE_APP_DEBUG === 'true'
|
||
</script>
|
||
```
|
||
|
||
### 在 JS/TS 文件中使用
|
||
|
||
```js
|
||
// 使用 import.meta.env 访问环境变量
|
||
const baseUrl = import.meta.env.VITE_APP_BASE_URL
|
||
const isDebug = import.meta.env.VITE_APP_DEBUG === 'true'
|
||
|
||
// 获取当前环境模式
|
||
const mode = import.meta.env.MODE
|
||
```
|
||
|
||
## 获取当前环境
|
||
|
||
```js
|
||
// 获取当前环境模式（development、production等）
|
||
const mode = import.meta.env.MODE
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. 所有环境变量必须以 `VITE_` 开头才能在客户端代码中访问
|
||
2. 环境变量默认为字符串类型，需要自行转换为其他类型（如布尔值）
|
||
3. 修改环境变量后需要重启开发服务器才能生效
|
||
4. 不要在环境变量文件中存储敏感信息，如API密钥等
|