快速开始

环境

• Node 20+ 与 pnpm
• 已按指南装好并启动后端
• 调试微信小程序时还需微信开发者工具

H5 开发态请先把 uniapp/vite.config.ts 里 /api、/storage、/static 的代理 target 改成 http://127.0.0.1:8000，与全站默认后端端口一致（若你已在其它端口跑后端，也可改 SERVER_LISTEN）。仓库里该 target 默认仍是 http://localhost:8005，联调前必须对齐；不要另起第三个端口。

安装与开发

cd uniapp
pnpm install
pnpm dev:h5
pnpm dev:mp-weixin

• pnpm dev:h5：浏览器打开 H5；开发态请求走上述 Vite 代理。非 H5 构建可设 VITE_APP_API_URL 直连后端。
• pnpm dev:mp-weixin：产出微信小程序工程，用微信开发者工具打开编译目录；manifest.json 里填写小程序 AppID，并在管理端「渠道 → 小程序」配好后端凭证。

其它端的 dev:* / build:* 脚本见 uniapp/package.json，按目标平台选用。

类型检查

cd uniapp
pnpm type-check

联调注意

1. 请求统一走 uniapp/src/utils/request.ts，会带 Authorization（会员 JWT）与 X-Client-Type（miniapp / wechat_h5 / h5 / app），供后端按端区分支付与登录。
2. 先启动 php start.php start，再开 H5 / 小程序，否则代理与接口会失败。
3. H5 访问路径前缀为 /mobile/，与后端 SPA 路由一致。