小程序代码开发完成后，需要经过预览、上传、提交审核、发布上线这几个核心环节。很多新手开发者容易卡在“提交审核”这一步，或者因为测试不充分导致审核被驳回。本教程将带你完整走一遍从本地预览到代码上传、再到提交审核的全流程，确保每一步操作都有据可依。
## 前言介绍
小程序代码编写完成后，并不是直接就能在微信里打开使用的。微信官方对小程序有一套严格的审核机制，所有代码必须通过微信开发者工具上传到微信服务器，然后在微信公众平台提交审核，审核通过后才能发布上线。这个过程涉及三个主要角色：微信开发者工具（本地开发环境）、微信公众平台（后台管理）、微信客户端（用户端）。本教程会详细拆解从本地预览到最终提交审核的每个操作细节，包括如何生成测试版本、如何填写审核信息、如何处理常见的审核驳回问题。
## 前置准备
在开始操作前，请确保你具备以下条件：
1. **微信开发者工具**：已安装最新版本（建议从官网下载稳定版，不要使用预览版）。如果你还没有安装，访问微信开放平台官网，找到“开发者工具”下载安装。
2. **小程序AppID**：在微信公众平台（mp.weixin.qq.com）注册小程序后，在“开发”->“开发设置”中获取。注意区分AppID和AppSecret，AppID是公开的，用于标识你的小程序。
3. **小程序代码**：代码已经完成开发，并且在本地可以正常运行。建议在提交前先清理掉所有测试用的console.log、调试代码和临时数据。
4. **微信公众平台账号**：拥有小程序的“管理员”或“开发者”权限。如果你只是开发者，需要管理员在后台为你授权。
5. **稳定的网络环境**：上传代码和提交审核需要连接微信服务器，建议使用有线网络或稳定的WiFi，避免使用代理或VPN，否则可能上传失败。
6. **版本号规划**：提前想好本次提交的版本号，例如v1.0.0、v1.0.1等。版本号规则建议遵循语义化版本（主版本.次版本.修订号）。
## 分步操作步骤
### 1. 在开发者工具中预览测试版本
预览的目的是在真机上模拟用户使用体验，发现代码在真实设备上的问题，比如界面适配、网络请求、权限弹窗等。这一步不能跳过，很多审核被驳回的原因都是因为开发者没有在真机上测试。
- 打开微信开发者工具，点击顶部菜单栏的“预览”按钮（或使用快捷键Ctrl+Shift+P / Cmd+Shift+P）。
- 工具会生成一个二维码，这个二维码是临时预览码，有效期大约30分钟。用手机微信扫描二维码，即可在手机上打开你的小程序测试版本。
- 注意：预览版本使用的是你当前本地代码，不会影响线上版本。预览时，手机和电脑必须在同一局域网下，或者电脑开启了“远程调试”功能（在工具设置中开启）。
- 在手机上逐页逐功能测试：点击每个按钮、输入框、跳转链接、支付流程（如果有）、登录流程等。特别注意测试边界情况，比如网络断开、数据为空、输入特殊字符等。
- 如果发现bug，直接在开发者工具中修改代码，保存后重新点击“预览”生成新的二维码，手机端刷新即可看到最新效果。重复这个过程直到所有功能正常。
### 2. 上传代码到微信服务器
预览确认无误后，需要将代码上传到微信服务器，这样微信公众平台才能获取到你的代码包。
- 在微信开发者工具中，点击顶部菜单栏的“上传”按钮（或使用快捷键Ctrl+Shift+U / Cmd+Shift+U）。
- 弹出上传窗口，需要填写两个关键信息：
- **版本号**：输入你规划的版本号，例如“1.0.0”。注意不要使用“v1.0.0”这种带v前缀的格式，微信官方建议纯数字点号格式。
- **项目备注**：简单描述本次上传的内容，例如“修复了登录闪退问题，优化了首页加载速度”。这个备注会显示在微信公众平台的版本列表中，方便你和团队成员识别。
- 点击“上传”按钮，工具会开始打包代码并上传。上传速度取决于代码包大小和网络状况，一般几秒到几十秒不等。上传过程中不要关闭工具或断开网络。
- 上传成功后，工具会弹出提示“上传成功”。此时你的代码已经存储在微信服务器上，但还没有提交审核，线上用户仍然看不到。
### 3. 在微信公众平台提交审核
代码上传到服务器后，需要登录微信公众平台进行审核提交。
- 打开浏览器，访问微信公众平台（mp.weixin.qq.com），使用小程序管理员或开发者的微信扫码登录。
- 登录后，在左侧菜单栏找到“版本管理”或“开发管理”->“版本管理”（不同版本的后台界面可能略有差异，但功能位置一致）。
- 在版本管理页面，你会看到“开发版本”列表，刚才上传的代码会显示在这里。找到你刚刚上传的版本，点击右侧的“提交审核”按钮。
- 进入提交审核页面，需要填写以下信息：
- **审核描述**：这是审核人员看到的说明，必须清晰描述小程序的功能、用途、目标用户。例如“本小程序是一个在线点餐工具，用户可以选择菜品、下单、支付，商家可以接单和查看订单。”不要写“测试版本”或“随便看看”这类无效描述，否则会被驳回。
- **功能页面**：选择小程序中需要审核人员重点查看的页面。一般选择首页、核心功能页、支付页等。如果小程序有多个tab页面，建议每个tab都选一个代表页面。
- **测试账号**：如果小程序需要登录才能使用，必须提供测试账号和密码。审核人员会用这个账号登录测试。账号权限要能覆盖所有功能，不要设置权限限制。如果不需要登录，可以忽略此项。
- **备注**：可以填写一些特殊说明，比如“支付功能在测试环境无法完成，请使用沙箱账号测试”或“部分功能需要用户授权地理位置，请允许权限”。
- 填写完毕后，勾选“我已阅读并同意《微信小程序平台运营规范》”，点击“提交审核”按钮。
- 提交成功后，页面会显示“审核中”。审核时间通常为1-7个工作日，紧急情况可以申请加急（部分类目支持，需付费）。
### 4. 查看审核状态与发布上线
提交审核后，需要持续关注审核进度，并根据结果处理。
- 在“版本管理”页面，找到已提交审核的版本，状态会显示“审核中”。点击“查看详情”可以查看审核进度。
- 如果审核通过，状态会变为“审核通过”。此时你可以选择“发布”或“撤回”。点击“发布”即可将代码正式上线，所有用户都可以访问。注意：发布后无法立即撤回，如果需要回滚，只能重新上传旧版本并再次审核。
- 如果审核被驳回，状态会显示“审核未通过”，并附上驳回原因。常见驳回原因包括：
- 功能不完整或无法使用（比如点击按钮没反应、页面空白）
- 涉及敏感内容（比如未经许可的新闻、医疗、金融信息）
- 存在诱导分享、强制关注等违规行为
- 测试账号无法登录或功能受限
- 界面与描述不符
- 根据驳回原因，回到开发者工具修改代码，然后重新执行“上传”和“提交审核”步骤。注意：每次修改后都必须重新上传代码并提交审核，不能直接修改已提交的版本。
- 如果审核通过但暂时不想发布，可以选择“不发布”，代码会保持在“审核通过”状态。后续随时可以点击“发布”按钮上线。
## 常见问题
**Q1：上传代码时提示“代码包过大”怎么办？**
A：微信小程序代码包大小限制为2MB（主包）+ 2MB（分包）。如果超过限制，需要优化代码：压缩图片（使用WebP格式）、移除未使用的库文件、启用分包加载（将非首页功能拆分成多个分包）。在开发者工具中点击“详情”->“本地代码”可以查看当前包大小。
**Q2：提交审核后多久能通过？**
A：一般1-7个工作日，但实际速度取决于审核队列和类目。工具类、生活服务类通常较快，金融、医疗、社交等敏感类目可能较慢。如果超过7个工作日没有结果，可以在微信公众平台“版本管理”页面点击“催审”按钮（部分账号有权限）。
**Q3：为什么预览正常，但审核人员说功能无法使用？**
A：常见原因有三：一是预览时使用了本地开发环境（比如localhost接口），审核人员无法访问；二是测试账号权限不足，审核人员无法登录；三是某些功能依赖特定设备（比如蓝牙、NFC），审核人员的测试机不支持。建议在提交审核前，用一台干净的手机（未登录过开发者微信）扫描预览码测试，确保功能完整可用。
**Q4：审核通过后，发现代码有bug怎么办？**
A：如果已经发布，只能紧急修复后重新上传并提交审核。如果还未发布，可以撤回审核（在版本管理页面点击“撤回”），修改代码后重新上传提交。注意：撤回后该版本作废，需要重新走一遍上传-审核流程。
**Q5：提交审核时提示“请先完成小程序认证”是什么情况？**
A：微信小程序需要完成微信认证（支付300元认证费）才能使用支付、附近的小程序、微信广告等功能。如果只是基础功能（展示信息、表单提交等），可以不认证直接提交审核。认证流程在微信公众平台“设置”->“基本设置”->“微信认证”中操作。
## 收尾总结
小程序代码上传提交审核是一个标准化的流程，核心就三步：本地预览确保功能正常、上传代码到服务器、在公众平台提交审核。关键点在于预览阶段要彻底测试所有功能，审核描述要清晰准确，测试账号要准备到位。很多新手因为忽略真机测试或审核描述敷衍导致反复被驳回，浪费大量时间。按照本教程的步骤操作，每一步都认真执行，通常一次就能顺利通过审核。如果你在操作过程中遇到其他问题，可以查阅微信官方文档“小程序审核指南”或联系微信开发者社区。