小程序开发部署流程完整指南

小程序开发部署流程完整指南本文详细介绍微信小程序从本地开发、构建、上传到正式发布的完整部署流程以 Taro React 技术栈为例。一、小程序部署的本质小程序与公众号不同前端代码运行在微信提供的沙箱环境中代码需上传到微信服务器由微信负责分发和运行。因此❌不需要验证文件❌不需要服务器 URL 校验✅只需要配置 request 等合法域名让小程序能请求你的后端 API二、小程序部署全流程图第四阶段审核与发布通过拒绝体验版测试提交审核微信审核审核结果发布正式版修改后重新提交第三阶段微信后台配置配置服务器域名设置体验版成员管理第二阶段构建与上传npm run build:weapp生成 dist/ 编译产物微信开发者工具打开项目点击上传代码上传至微信服务器第一阶段前置准备注册小程序获取 AppID部署后端 API 服务配置生产环境变量三、详细部署步骤3.1 第一阶段前置准备3.1.1 注册小程序登录 微信公众平台选择「小程序」类型注册完成主体认证企业需营业执照获取AppID开发 → 开发管理 → 开发设置3.1.2 部署后端 API小程序会通过wx.request等接口请求你的后端需确保后端已部署到服务器使用HTTPS正式环境必须记录 API 地址如https://api.example.com3.1.3 配置生产环境变量在项目根目录的.env.production中配置TARO_APP_IDwx28xxxxxxxxxxxxxTARO_APP_APIhttps://api.example.com3.2 第二阶段构建与上传3.2.1 安装依赖并构建# 安装依赖npminstall# 生产环境构建以 Taro 为例npmrun build:weapp构建完成后产物在dist/目录。3.2.2 上传流程说明微信开发者工具是连接本地与微信服务器的桥梁微信服务器微信开发者工具开发者微信服务器微信开发者工具开发者1. 点击「上传」2. 读取 dist/ 编译产物3. 打包成上传包4. HTTPS 上传5. 校验 AppID、签名6. 保存为开发版本7. 返回成功8. 提示上传完成操作步骤打开微信开发者工具微信扫码登录导入项目选择项目根目录不是 dist/填写 AppID顶部菜单点击「上传」填写版本号如1.0.0和版本描述点击「上传」权限要求只有管理员和开发者可以上传体验者无权限。3.3 第三阶段微信后台配置3.3.1 配置服务器域名路径开发 → 开发管理 → 开发设置 → 服务器域名域名类型用途示例request 合法域名业务 API 请求https://api.example.comuploadFile 合法域名文件上传同上若接口同域名downloadFile 合法域名文件下载若有独立下载域名则填写注意域名需备案且支持 HTTPS。不需要像公众号那样放置验证文件。3.3.2 版本管理路径开发 → 开发管理 → 版本管理开发版本上传后的代码体验版本设为体验版后体验成员可扫码体验正式版本审核通过后发布给用户3.3.3 成员管理路径管理 → 成员管理开发者可上传代码、调试体验者可扫码体验体验版管理员可提交审核、发布3.4 第四阶段审核与发布3.4.1 体验版测试将上传的版本设为「体验版」体验成员扫码体验验证登录、核心功能是否正常有问题则修改代码 → 重新构建 → 重新上传3.4.2 提交审核版本管理 → 开发版本 →提交审核填写版本描述、测试账号如需登录配置类目如金融、教育等等待微信审核通常 17 天3.4.3 正式发布审核通过点击「发布」用户即可使用审核拒绝按拒绝原因修改后重新提交四、本地开发调试流程修改 src/ 代码Taro 自动编译到 dist/微信开发者工具热重载预览窗口刷新启动命令npmrun dev:weapp注意本地调试时需在微信开发者工具中勾选「不校验合法域名」否则请求可能被拦截。五、部署检查清单步骤检查项状态1TARO_APP_API 为正式 HTTPS 地址☐2微信公众平台「服务器域名」已配置 API 域名☐3后端服务已部署并可正常访问☐4npm run build:weapp构建无报错☐5体验版功能测试通过☐6类目、资质符合微信要求☐7测试账号已提供给审核如需要☐六、总结小程序部署流程相对简洁构建 → 上传 → 配置域名 → 体验测试 → 提交审核 → 发布。无需验证文件、服务器 URL 校验等公众号特有的配置因为小程序代码托管在微信侧只需确保能安全地请求你的后端 API 即可。