Skip to content

环境变量与配置 ​

项目使用 Vite 环境变量文件。VITE_ 前缀的变量暴露给前端代码,其余仅在 vite.config.ts 等 Node 侧使用。

环境文件 ​

文件加载时机说明
.env.developmentpnpm dev端口、代理目标、Mock 开关
.env.productionpnpm 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_ENABLEDMock 开关,仅开发生效false
VITE_TENANT_ENABLED多租户开关false
VITE_AI_ENABLEDAI 辅助功能开关开发 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 侧变量中。

相关文档 ​

基于 MIT 许可发布 · 如需部署协助或二开定制,请查看 支持与合作