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

本文详细介绍微信小程序从本地开发、构建、上传到正式发布的完整部署流程，以 Taro + React 技术栈为例。

---

一、小程序部署的本质

小程序与公众号不同：前端代码运行在微信提供的沙箱环境中，代码需上传到微信服务器，由微信负责分发和运行。因此：

• ❌ 不需要验证文件
• ❌ 不需要服务器 URL 校验
• ✅ 只需要配置 request 等合法域名，让小程序能请求你的后端 API

---

二、小程序部署全流程图

---

三、详细部署步骤

3.1 第一阶段：前置准备

3.1.1 注册小程序

1. 登录 微信公众平台
2. 选择「小程序」类型注册
3. 完成主体认证（企业需营业执照）
4. 获取 AppID（开发 → 开发管理 → 开发设置）

3.1.2 部署后端 API

小程序会通过 wx.request 等接口请求你的后端，需确保：

• 后端已部署到服务器
• 使用 HTTPS（正式环境必须）
• 记录 API 地址，如 https://api.example.com

3.1.3 配置生产环境变量

在项目根目录的 .env.production 中配置：

TARO_APP_ID="wx28xxxxxxxxxxxxx"
TARO_APP_API="https://api.example.com"

---

3.2 第二阶段：构建与上传

3.2.1 安装依赖并构建

# 安装依赖
npm install

# 生产环境构建（以 Taro 为例）
npm run build:weapp

构建完成后，产物在 dist/ 目录。

3.2.2 上传流程说明

微信开发者工具是连接本地与微信服务器的桥梁：

操作步骤：

1. 打开微信开发者工具，微信扫码登录
2. 导入项目：选择项目根目录（不是 dist/）
3. 填写 AppID
4. 顶部菜单点击「上传」
5. 填写版本号（如 1.0.0）和版本描述
6. 点击「上传」

权限要求： 只有管理员和开发者可以上传，体验者无权限。

---

3.3 第三阶段：微信后台配置

3.3.1 配置服务器域名

路径：开发 → 开发管理 → 开发设置 → 服务器域名

域名类型	用途	示例
request 合法域名	业务 API 请求	https://api.example.com
uploadFile 合法域名	文件上传	同上（若接口同域名）
downloadFile 合法域名	文件下载	若有独立下载域名则填写

注意： 域名需备案，且支持 HTTPS。不需要像公众号那样放置验证文件。

3.3.2 版本管理

路径：开发 → 开发管理 → 版本管理

• 开发版本：上传后的代码
• 体验版本：设为体验版后，体验成员可扫码体验
• 正式版本：审核通过后发布给用户

3.3.3 成员管理

路径：管理 → 成员管理

• 开发者：可上传代码、调试
• 体验者：可扫码体验体验版
• 管理员：可提交审核、发布

---

3.4 第四阶段：审核与发布

3.4.1 体验版测试

1. 将上传的版本设为「体验版」
2. 体验成员扫码体验
3. 验证登录、核心功能是否正常
4. 有问题则修改代码 → 重新构建 → 重新上传

3.4.2 提交审核

1. 版本管理 → 开发版本 → 提交审核
2. 填写版本描述、测试账号（如需登录）
3. 配置类目（如金融、教育等）
4. 等待微信审核（通常 1～7 天）

3.4.3 正式发布

• 审核通过：点击「发布」，用户即可使用
• 审核拒绝：按拒绝原因修改后重新提交

---

四、本地开发调试流程

启动命令：

npm run dev:weapp

注意： 本地调试时，需在微信开发者工具中勾选「不校验合法域名」，否则请求可能被拦截。

---

五、部署检查清单

步骤	检查项	状态
1	TARO_APP_API 为正式 HTTPS 地址	☐
2	微信公众平台「服务器域名」已配置 API 域名	☐
3	后端服务已部署并可正常访问	☐
4	npm run build:weapp 构建无报错	☐
5	体验版功能测试通过	☐
6	类目、资质符合微信要求	☐
7	测试账号已提供给审核（如需要）	☐

---

六、总结

小程序部署流程相对简洁：构建 → 上传 → 配置域名 → 体验测试 → 提交审核 → 发布。无需验证文件、服务器 URL 校验等公众号特有的配置，因为小程序代码托管在微信侧，只需确保能安全地请求你的后端 API 即可。