hbuilderx发布微信小程序需三步:本地编译→上传微信后台→提交审核;manifest.json中mp-weixin配置必须准确,appid须与微信公众平台完全一致,且vue版本、网络权限、ip白名单、版本号递增等均需合规。

HBuilderX 发布微信小程序不是一键完成的事,必须分三步走:本地编译 → 上传到微信后台 → 提交审核。跳过任何一步,代码都不会出现在线上版本里。
manifest.json 中的 mp-weixin 配置必须准确
这是整个流程的前提。如果 appid 填错、漏填,或者和微信公众平台注册的小程序 ID 不一致,后续所有操作都会失败——要么编译报错,要么上传后在微信开发者工具里看不到项目,或者上传成功但版本管理里查不到。
-
appid必须和微信公众平台「开发管理 → 开发设置」里的 AppID 完全一致(区分大小写,不能多空格) - 如果项目是 uni-app,
manifest.json的mp-weixin节点下不能只写appid,还要确保setting.urlCheck设为false(否则本地调试时可能因域名未备案而白屏) - 若使用了云函数或 wx.request 请求后端,
manifest.json中的networkTimeout和permission也要按需补全,否则审核可能被拒
HBuilderX 点击「发行 → 小程序-微信」后,别直接关掉微信开发者工具
这一步实际做了两件事:先编译生成 unpackage/release/mp-weixin 目录,再自动用你配置好的微信开发者工具路径打开该目录。很多人上传失败,是因为工具没加载完就点了「上传」按钮,或误关了窗口。
由于微信的大热,为了更好的方便使用微信的用户查询一些信息,这篇文章是入门级的微信公众平台开发教程,需要的朋友可以参考下 这篇入门教程将引导你完成如下任务: 创建百度云平台应用启用微信公众平台开发模式获取订阅、文字、图片、语音、视频消息回复文本、图文及音乐消息程序开发
- 确认微信开发者工具右上角显示「已编译」且控制台无报错(常见错误:
Cannot find module 'vue'表示 Vue 版本不匹配,需检查项目是否为 Vue2/Vue3 并安装对应编译插件) - 上传前务必点击工具栏的「编译」按钮(不是「预览」),否则上传的是旧代码
- 如果勾选了「自动上传」但失败,错误信息通常是
errCode:-10008,说明当前 IP 不在微信公众平台「开发设置 → 小程序代码上传 → IP 白名单」中,需手动添加
上传成功 ≠ 可上线,版本管理里要手动提交审核
上传完成后,代码只进入「开发版本」列表,不会自动变成体验版或线上版。不进微信公众平台操作,用户永远搜不到你的小程序。
- 登录 mp.weixin.qq.com,进入「管理 → 版本管理」,找到刚上传的条目(时间最新、状态为「开发中」)
- 首次提交必须填写「用户隐私保护指引」,否则卡在提交环节;若跳过,会提示「请完善小程序发布信息」
- 截图上传至少 2 张(要求清晰展示首页+核心功能页),格式必须是
.jpg或.png,单张不超过 5M;视频非必填,但加了能提高审核通过率 - 如果选了「加急审核」,需额外支付 30 元/次,且仅对已认证主体开放;未认证的小程序只能走普通流程(通常 1–7 个工作日)
真正容易被忽略的点是:每次修改代码后重新发行上传,版本号必须递增(如从 1.0.0 改成 1.0.1),微信后台会校验版本号是否大于当前线上版本。用相同版本号上传,后台会静默拒绝,但 HBuilderX 控制台不报错,你会以为上传成功了,其实什么都没更新。










