项目部署

构建命令

平台	命令	产物目录
微信小程序	pnpm build:mp-weixin	dist/build/mp-weixin/
H5	pnpm build:h5	dist/build/h5/
App	pnpm build:app	使用 HBuilderX 云打包

微信小程序发布

1. 打开微信开发者工具
2. 导入 dist/build/mp-weixin 目录
3. 点击「上传」提交审核

H5 部署

将 dist/build/h5/ 部署到静态服务器，Nginx 配置示例：

server {
    listen 80;
    server_name your-domain.com;
    root /var/www/youlai-app;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /prod-api/ {
        proxy_pass http://localhost:8787/;
    }
}

环境变量

文件	说明
.env.development	开发环境（/dev-api 代理）
.env.production	生产环境（/prod-api 代理）

关键变量：

变量	说明
VITE_APP_BASE_API	API 代理前缀
VITE_APP_API_URL	后端完整地址（微信小程序使用）

常见问题

Q: 微信小程序上传体积超限？

• 检查分包配置、图片使用 CDN、开启上传压缩

Q: H5 部署后刷新 404？

• Nginx 配置 try_files $uri $uri/ /index.html;

Q: App 端网络请求失败？

• 检查 Android 网络安全配置，允许 HTTP 或配置 HTTPS