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密钥等
|