环境变量与配置
项目使用 Vite 环境变量文件。VITE_ 前缀的变量暴露给前端代码,其余仅在 vite.config.ts 等 Node 侧使用。
环境文件
| 文件 | 加载时机 | 说明 |
|---|---|---|
.env.development | pnpm dev | 端口、代理目标、Mock 开关 |
.env.production | pnpm build | 生产默认值,入库 |
.env.youlai | 线上部署构建 | 只写与 production 的差异项,不入库 |
同名变量按 Vite 规则覆盖:模式文件优先于通用文件。
变量一览
| 变量 | 说明 | 默认值 |
|---|---|---|
APP_PORT | 开发服务器端口(Node 侧) | 3000 |
API_PROXY_TARGET | 开发代理转发目标(Node 侧) | https://www.youlai.tech |
VITE_APP_TITLE | 站点标题 | vue3-element-admin |
VITE_API_BASE | 请求前缀,开发环境即代理匹配前缀 | 开发 /dev-api,生产 /prod-api |
VITE_BASE_URL | 站点根路径,部署在子路径时修改 | / |
VITE_MOCK_ENABLED | Mock 开关,仅开发生效 | false |
VITE_TENANT_ENABLED | 多租户开关 | false |
VITE_AI_ENABLED | AI 辅助功能开关 | 开发 false,生产 true |
VITE_OIDC_ENABLED | 统一认证登录开关 | false |
开关取值均为字符串 "true" / "false"。新增变量时在 types/env.d.ts 补充类型声明。
连接本地后端
修改 .env.development 的代理目标后重启 dev server:
bash
API_PROXY_TARGET=http://localhost:8000开发请求链路:浏览器请求 /dev-api/api/v1/users → Vite 代理去掉 /dev-api 前缀 → 转发到 API_PROXY_TARGET。生产环境由 Nginx 将 /prod-api/ 转发到后端,见项目部署。
不要存放密钥
VITE_ 变量会打包进前端产物,任何人可见。密钥只能放在后端或 Node 侧变量中。
