Hbuilderx编译正常但无法打开微信开发者工具
约 1021 字大约 3 分钟
2025-08-11
上篇博客 vue2、vue3 以及相关脚手架之间的关系 测试了 vue
版本和 Node.js
、vue
脚手架之间的关系。为了测试,我把电脑上的 Node.js
版本换成了 v16.20.2
,测试结果是:
经过测试,Node.js 16.20.2
可以运行 vue2
项目、vue-cli
创建的 vue3
项目、早期 vue-create
和 vite
创建的 vue3
项目;但是不能运行最新 vue-create
、vite
创建的项目(要求 v20
以上)
由于 v16.20.2
暂时可以运行我的 vue2
和 vue3
项目,所以我就没有升级,而是保持着 Node.js 16.20.2
的状态。直到今天打开小程序,发现 HbuilderX
点击运行到微信小程序后迟迟不能打开微信开发者工具。
项目是以前的项目,设置肯定没有问题。
微信开发者工具是最新版,安装路径没有变。
登录的账号是开发者,也没有问题。
甚至
HbuilderX
的提示都是对的,也提示微信开发者工具已经打开了:[广告] 16:10:16.236 uni-cdn,比主流云厂商便宜 30%,更具性价比!详情 16:10:16.270 项目 uniapp-demo-page 开始编译 16:10:17.606 请注意运行模式下,因日志输出、sourcemap 以及未压缩源码等原因,性能和包体积,均不及发行模式。若要正式发布,请点击发行菜单或使用 cli 发布命令进行发布 16:10:17.607 小程序各家浏览器内核及自定义组件实现机制存在差异,可能存在样式布局兼容问题,参考:https://uniapp.dcloud.io/matter?id=mp 16:10:17.607 正在编译中... 16:10:30.477 [警告 ⚠] `components\echarts-uniapp\echarts.min.js` 文件体积超过 500KB,已跳过压缩以及 ES6 转 ES5 的处理,手机端使用过大的 js 库影响性能。 16:10:38.834 WARNING: Module Warning (from ./node_modules/@dcloudio/vue-cli-plugin-uni/packages/vue-loader/lib/loaders/templateLoader.js): 16:10:38.834 (Emitted value instead of an instance of Error) <uni-forms-item v-for="item in formDataDynamic.value">: component lists rendered with v-for should have explicit keys. See https://vuejs.org/guide/list.html#key for more info. 16:10:38.847 项目 uniapp-demo-page 编译成功。前端运行日志,请另行在小程序开发工具的控制台查看。 16:10:38.847 正在启动微信开发者工具... 16:10:39.270 [微信小程序开发者工具] - initialize 16:10:39.316 [微信小程序开发者工具] √ IDE server has started, listening on http://127.0.0.1:26165 16:10:39.316 [微信小程序开发者工具] - open IDE 16:10:40.217 [微信小程序开发者工具] √ open IDE 16:10:40.249 微信开发者工具已启动,在 HBuilderX 中修改文件并保存,会自动刷新微信模拟器。 16:10:40.249 注: 16:10:40.249 1. 可以通过微信开发者工具切换 pages.json 中 condition 配置的页面,或者关闭微信开发者工具,然后再从 HBuilderX 中启动指定页面 16:10:40.249 2. 如果出现微信开发者工具启动后白屏的问题,检查是否启动多个微信开发者工具,如果是则关闭所有打开的微信开发者工具,然后再重新运行 16:10:40.249 3. 运行模式下不压缩代码且含有 sourcemap,体积较大;若要正式发布,请点击发行菜单进行发布
而微信开发者工具清理缓存、重启都试了,毫无反应。
但奇怪的是如果手动导入 Hbuilder X
编译的 mp-weixin
文件,微信开发者工具可以正常运行,甚至还能同步 Hbuilder X
的修改。
经过各种查找,有一篇博客提到了 Node.js
版本 问题:HBuilderX 启动到微信开发着工具打开后没反应
然后我把 Node.js
从 v16
升级到了 v22.15.1
,重启电脑后, Hbuilder X
就可以正常唤醒微信开发者工具了。
结论
Node.js
版本太低,升级版本、重启电脑即可。