一、打开 微信公众平台 注册小程序 需要一个邮箱
二、基础信息查询:查看AppID
AppID是小程序开发、调试的核心标识,查询路径如下:
左侧菜单 → 开发者与服务 → 开发管理 → 开发设置(AppID会在此页面明确展示)
三、关键操作指引
1. 添加管理员、开发者、运营者(权限分配)
管理员需按以下路径为成员分配开发者权限,确保协作开发:
左侧菜单 → 管理 → 成员管理 → 点击添加 → 输入微信号 → 勾选对应权限(参考“核心权限清单”选择所需权限)
权限对比速览(开发者 vs 管理员 vs 运营者)
| 操作 | 开发者 | 管理员 | 运营者 |
|---|---|---|---|
| 开发调试 / 上传代码 | ✅ | ✅ | ❌ |
| 配置服务器域名 | ✅(需开发设置) | ✅ | ❌ |
| 提交审核 / 发布 | ❌ | ✅ | ✅(需开发管理) |
| 修改基础信息 | ❌ | ✅ | ❌ |
| 查看数据分析 | ❌(需授权) | ✅ | ✅(需授权) |
| 管理成员权限 | ❌ | ✅ | ❌ |
开发者权限
| 开发调试 | 使用开发者工具、真机调试、开发版小程序 | 微信开发者工具(绑定对应 AppID) |
|---|---|---|
| 版本管理 | 上传开发版代码、删除本人开发版(不影响线上 / 审核中版本) | 开发者工具→版本管理;后台 “开发管理→开发版本” |
| 开发设置 | 配置服务器域名、业务域名、消息推送、普通链接二维码规则 | 后台 “设置→开发设置” |
| 体验管理 | 添加 / 移除体验成员(需登录权限) | 后台 “用户身份→体验成员管理” |
| 云开发(默认) | 云函数、数据库、存储、云托管等基础操作(未单独配置时) | 云开发控制台(权限由管理员或云开发管理员分配) |
| 后台登录 | 登录小程序管理后台(需管理员单独授权 “登录” 权限) | mp.weixin.qq.com |
2. 发布流程(权限关联操作)
注:开发者无发布权限,该流程供管理员/运营者参考:
基本信息配置:登录小程序管理后台 → 鼠标移入左侧头像 → 点击账号设置 → 前往填写(完成发布前必要配置)
服务器域名配置: 登录小程序管理后台 → 左侧菜单 → 开发 → 开发设置 → 服务器域名
小程序备案 说明网址
代码发布微信: 开发者工具→ 右上角上传按钮 → 填写版本号和描述
小程序版本: 登录小程序管理后台 → 左侧菜单 → 测试 → 管理 → 版本管理 → (页面最下方)开发版本 → 配置为体验版本(仅左侧菜单 → 管理 → 成员管理中显示的人员可以看到【其他人员访问会出现申请体验页面】) → 测试体验版本 → 提交审 → 线上版本
小程序版本审核时间
| 审核类型 | 官方时效 | 实际常见时效 | 说明 |
|---|---|---|---|
| 常规审核 | 1–7 个工作日 | 24–48 小时 | 类目合规、材料齐全更快;周末 / 节假日顺延developers.weixin.qq.com |
| 版本更新 | 同常规 | 几小时–1 天 | 非首次、改动小、无敏感内容更高效 |
| 加急审核 | 约 2 小时 | 约 2 小时 | 需有加急额度;队列拥堵或复杂逻辑可能延长 |
| 驳回重提 | 同常规 | 1–3 天 | 若 12 小时内修正重提,部分可享优先审核 |
四、配置域名
如果真机运行不显示图片 微信开发者工具上显示图片
1. 未配置合法域名(最常见)
-
开发者工具默认开启 “不校验合法域名”,但真机强制校验,非配置域名的图片无法加载。
-
解决方案:
- 登录小程序管理后台 → 开发 → 开发设置 → 服务器域名 → downloadFile合法域名(如
https://img.example.com); - 测试阶段可临时在开发者工具中勾选:详情 → 本地设置 → 不校验合法域名、web-view(仅真机调试用,上线前必须配置)。
- 登录小程序管理后台 → 开发 → 开发设置 → 服务器域名 → downloadFile合法域名(如
2. HTTPS 协议问题
- 小程序真机要求网络图片必须使用
HTTPS(开发者工具允许 HTTP),HTTP 图片会被拦截。 - 解决方案:将图片链接替换为 HTTPS,或配置域名时勾选 “忽略 HTTPS 证书校验”(仅测试用)。
3. 跨域 / 防盗链限制
-
部分图片服务器设置了防盗链(Referer 检查),真机请求时因 Referer 不同被拒绝。
-
解决方案:
- 联系图片服务商允许小程序域名的 Referer(如
servicewechat.com); - 后端中转图片(小程序请求后端接口,后端返回图片流)。
- 联系图片服务商允许小程序域名的 Referer(如
4. 图片链接失效或超时
-
开发者工具缓存了图片,但真机首次请求时链接已失效或加载超时。
-
解决方案:
- 检查图片链接是否可正常访问(复制链接到浏览器打开);
三、真机环境特殊限制
1. 图片尺寸 / 格式超限
-
部分真机对超大图片(如超过 10MB)或特殊格式(如 WebP,iOS 低版本不支持)兼容性差。
-
解决方案:
- 压缩图片大小(建议单张不超过 2MB);
- 使用兼容性更好的格式(PNG/JPG),避免 WebP(需兼容时可提供降级方案)。
2. 小程序基础库版本差异
-
低版本基础库可能不支持新的图片属性(如
lazy-load、mode="widthFix")。 -
解决方案:
-
在开发者工具中切换基础库版本测试(详情 → 调试基础库);
-
代码中增加兼容性判断: if (wx.getSystemInfoSync().SDKVersion < '2.10.0') { // 兼容低版本逻辑 }
-
3. 缓存问题
-
真机缓存了旧的图片资源或配置,导致新图片无法加载。
-
解决方案:
- 真机中删除小程序(彻底清除缓存)后重新打开;
- 图片链接添加版本号(如
https://xxx.jpg?v=2)。
四、快速排查步骤
- 区分本地 / 网络图片:将图片改为本地测试,若显示则是网络问题;
- 检查控制台报错:真机调试时打开 vConsole(右上角三点 → 调试),查看图片加载的错误信息(如 403/404);
- 简化测试代码:用最基础的
<image src="xxx"></image>测试,排除样式 / 逻辑干扰; - 切换真机网络:用 4G/5G 测试,排除 WiFi 代理或防火墙问题。
五、开通wx.getLoaction权限 提示暂无权限
wx.getLocation官网说明地址
微信开放社区说明地址
六、实用网址、微信开放社区
可以在里面查找相关问题