HBuilderX成功调试微信小程序需打通通信链路:1.正确配置微信开发者工具路径(Windows为devtools.exe,macOS为WeChatWebDevTools);2.在微信开发者工具“设置→安全”中开启服务端口(默认53001);3.在manifest.json中填入有效AppID;4.运行时选择“微信开发者工具”,首次启动需5–15秒初始化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让Trae(即HBuilderX)成功调试微信小程序项目,必须打通HBuilderX与微信开发者工具之间的通信链路,否则编译后无法自动加载、代码修改不刷新、真机预览失败——所有联调功能都将失效。
配置微信开发者工具路径
打开HBuilderX → 【工具】→【设置】→【运行配置】→【微信开发者工具路径】;
点击右侧“浏览”按钮,精准定位到微信开发者工具的可执行文件(Windows下为 devtools.exe,macOS下为 WeChatWebDevTools.app/Contents/MacOS/WeChatWebDevTools);
路径必须指向可执行文件本身,而非文件夹,填错会导致后续所有联调操作静默失败。
开启微信开发者工具服务端口
启动微信开发者工具 → 左上角【设置】→【安全】→ 勾选“服务端口”;
该端口默认为 53001,HBuilderX正是通过此端口向微信开发者工具发送项目路径和编译指令;
【未勾选此项,HBuilderX无论怎么点击“运行到小程序模拟器”,微信开发者工具都不会响应】。
配置AppID并启用自动联调
在HBuilderX中打开uni-app项目 → 打开 manifest.json → 在“基础配置”中填入已在微信公众平台注册的小程序AppID;
保存后,点击顶部菜单栏【运行】→【运行到小程序模拟器】→【微信开发者工具】;
HBuilderX会自动触发编译、生成临时文件,并通过服务端口通知微信开发者工具打开对应项目;
首次运行需等待约5–15秒,因需构建依赖、注入调试脚本、初始化模拟器环境。
Windows 微信自动发送工具。支持搜索微信联系人并发送文字、图片、文件和**批量文件**。通过 GUI 自动化控制微信窗口,无需微信开放接口。触发场景: 离开电脑时,远程指令OpenClaw发送图片/文件给微信联系人。条件: 微信打开并登录(允许最小化)。举例:1、把桌面上的龙虾图片发送给张三(默认微信发送);2、查找D盘最新的报价单Excel表并发送给李四(默认微信发送);3、搜索报价单并批量发送给联系人。
真机调试与网络请求调试实操
方法一:扫码真机预览
微信开发者工具内点击【预览】→ 生成二维码 → 微信手机客户端扫码即可在真实设备上运行;
此时HBuilderX中修改代码并保存,微信开发者工具模拟器会自动刷新,但真机不会同步刷新——需手动下拉刷新或重启小程序。
方法二:真机调试(带控制台日志)
确保手机与开发电脑处于同一局域网;
微信开发者工具中点击右上角【详情】→【本地设置】→ 勾选“不校验合法域名、HTTPS证书、web-view业务域名”;
在HBuilderX中启动项目后,用真机微信扫码进入 → 屏幕右下角出现vConsole图标 → 点击即可呼出移动端调试面板;
vConsole仅显示console日志与简单命令行,无法设断点或查看Sources,但能实时捕获真机环境下的网络异常、undefined错误和API返回结构。
方法三:抓包调试网络请求
若后端部署在本地电脑(如localhost:3000),需将请求地址改为电脑内网IP(如 http://192.168.1.100:3000);
在微信开发者工具中打开【调试器】→【Network】面板 → 刷新页面即可捕获全部 wx.request 请求;
【切勿使用 localhost 或 127.0.0.1,真机无法解析该地址,必然报 network error】。









