快速开始
环境准备
| 工具 | 版本要求 | 说明 |
|---|---|---|
| Node.js | ^20.19.0 或 >=22.12.0 | 推荐 LTS 版本 |
| pnpm | >= 8.0.0 | 包管理器 |
| 微信开发者工具 | 最新稳定版 | 仅小程序需要 |
克隆仓库
bash
git clone https://gitee.com/youlaiorg/youlai-app.git
cd youlai-app安装依赖
bash
pnpm install安装后如果提示 Ignored build scripts，执行以下命令选择需要授权构建脚本的依赖（如 esbuild、core-js、vue-demi）：
bash
pnpm approve-builds启动项目
H5
bash
pnpm run dev:h5默认端口由 .env.development 的 VITE_APP_PORT 控制。
微信小程序
编译：
bash
pnpm run dev:mp-weixin导入微信开发者工具：
- 导入目录：
dist/dev/mp-weixin - AppID：没有可使用测试号
本地设置（重要）：右上角 详情 → 本地设置：
- 勾选：不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书
- 取消勾选：过滤无依赖文件（否则可能导致组件无法加载）
环境变量
| 变量 | 说明 | 示例 |
|---|---|---|
VITE_APP_BASE_API | API 代理前缀（非微信小程序用） | /dev-api |
VITE_APP_API_URL | 后端完整地址（微信小程序用） | https://api.youlai.tech |
VITE_APP_PORT | H5 开发端口 | 4096 |
生产环境可在 .env.production 覆盖。
请求与鉴权
请求封装位于 src/utils/request.ts，有 token 自动携带 Authorization: Bearer <token>，401 时自动跳转登录页（防抖，不会重复跳转）。详见 数据请求。