必须先启用真机调试并设为2.0版本，更新微信至≥8.0.63，确保手机与电脑同局域网；android需开启usb调试及文件传输模式，ios需开启本地网络和web检查器权限，并可切换广域网模式扫码直连。
微信开发者工具真机调试连接不上、扫码无反应、iOS/Android设备反复断连或调试器空白，这些问题会直接卡住开发流程，必须逐项排查网络、设备、工具版本和权限设置等关键环节。
先确认基础条件是否满足
打开微信开发者工具 → 顶部菜单栏点击「项目」→「详情」→「本地设置」，勾选「启用真机调试」并确保「真机调试版本」为「2.0」（1.0版本已逐步停用，部分新机型完全不兼容）。
检查手机微信版本：进入手机微信 → 「我」→「设置」→「关于微信」，确认版本号 ≥ 8.0.63；低于此版本将无法建立稳定调试通道，【强制更新至最新版是必要前提】。
确认电脑与手机处于同一局域网：Wi-Fi名称和密码完全一致，禁用手机个人热点、蓝牙共享网络等干扰源。
Android设备连接失败专项修复
方法一：重置USB调试链路
第一步：在安卓手机「设置」→「关于手机」→连续点击「版本号」7次，激活开发者选项；
第二步：返回「设置」→「系统」→「开发者选项」→开启「USB调试」→同时将「USB调试（安全设置）」也打开；
第三步：连接数据线后，下拉手机通知栏，点击USB连接提示 → 选择「文件传输」模式（不是“仅充电”或“MTP”）；【选错模式会导致开发者工具完全识别不到设备】。
方法二：清除驱动与缓存
在Windows设备管理器中找到带黄色感叹号的Android设备 → 右键「卸载设备」→ 勾选「删除此设备的驱动程序软件」→ 拔插数据线触发重装驱动；
关闭开发者工具 → 删除其安装目录下的 temp 和 cache 文件夹 → 重启工具。
iOS设备扫码后无响应或报“发送失败”
方法一：重置调试授权链
在iPhone上打开「设置」→「隐私与安全性」→「本地网络」→ 找到「微信」并开启开关；
解析微信公众号文章，提取标题、作者、正文、图片等信息。用户发送链接（mp.weixin.qq.com）时触发，自动提取内容并可保存至飞书表格。
再进入「设置」→「Safari浏览器」→「高级」→ 确保「Web检查器」已开启；
最后回到微信 →「发现」→「小程序」→ 长按任意小程序 →「删除」该小程序调试记录，再重新扫码。
方法二：绕过局域网限制
开发者工具右上角「真机调试」按钮旁点击齿轮图标 → 关闭「使用局域网连接」→ 切换为「广域网模式」；
此时二维码底部会显示「广域网」字样，用iOS微信扫码即可直连，无需同网环境。
二维码生成失败或扫描后白屏
执行命令行检查项目体积（在项目根目录打开终端）：
du -sh ./ | awk '{print "当前项目体积:" $1}'
若输出体积 ≥ 4MB，立即启用分包：在 app.json 中配置 subNVue 或 subPackages，把非首页页面移入子包；
关闭开发者工具所有代理：「设置」→「代理」→ 选择「不使用任何代理」→ 重启工具；
清空DNS缓存：Mac用户执行 sudo killall -HUP mDNSResponder，Windows用户执行 ipconfig /flushdns。
控制台报错但调试器不加载源码
报错含 define is not defined 或 Cannot read 'toLowerCase' of undefined：说明工具底层模块异常，必须升级到 Nightly 版本；
访问 https://developers.weixin.qq.com/miniprogram/dev/devtools/nightly.html 下载安装最新 Nightly 包；
安装后首次启动时，工具会自动清理旧缓存并重建调试服务，【跳过此步将导致sources面板持续为空】。
