快速开始
环境要求
- Node.js(建议 LTS)
- pnpm
- 微信开发者工具(仅小程序)
安装依赖
在 youlai-app 目录执行:
bash
pnpm install启动 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 时自动跳转登录页(防抖,不会重复跳转)
- 微信小程序使用
VITE_APP_API_URL + url,其他平台使用VITE_APP_BASE_API + url
