• 开发者工具启动异常自助解决方案
• 1. win10 21H2 系统版本开发者工具卡死
• 2. win10 微信开发者工具安装完打不开（点击无反应）
• 3. 打开工具项目窗口卡死
• 4. Windows 工具图标展示不到的问题
• 5. Mac 13-14 工具打开不了立即闪退问题 (signal: trace/BPT trap)
• 6. Mac 工具启动在系统菜单能看到，但没有显示工具
• 其他问题可通过咨询解决

开发者工具启动异常自助解决方案

本文章积累收集一些开发者工具异常问题的解决方案，帮助用户能够自助且更高效率地解决问题。

1. win10 21H2 系统版本开发者工具卡死

表现：开启工具，能够打开窗口，但窗口会卡死，查看进程管理器，发现 ms-wx-file-watcher 进程一直卡死，停掉该进程能够正常走下去

相关帖子：

• 开发者工具文件监听导致打不开，卡死怎么办？ | 微信开放社区
• 系统更新后，开发工具打不开，关不掉，什么问题？ | 微信开放社区

问题原因：win10 21H2 系统版本更新，涉及对 .NEt Framework 的更新，导致编译的最简单的 C# exe 也会直接卡死

解决方案： 卸载相关的更新记录，重启电脑即可

2. win10 微信开发者工具安装完打不开（点击无反应）

表现：安装工具后，点击无反应打不开。查看工具日志 C:\Users\用户名\AppData\Local\微信开发者工具\User Data\80d774828fc67c7dafc59cd74ce70db0\WeappLog\launch.log

问题原因：通常是系统NUL这个驱动缺失或者不正确。

解决方案：

1.通过在 cmd （使用管理员权限打开）输入 sc start null 进行验证查看表现，正常情况执行上面命令是要出现“服务实例已在运行或者成功运行的展示”

2.如果出现OpenService 失败 1060,指定的服务未安装 则通常是注册表没有注册到 NULL 驱动。可以打开注册表首先确认下 NULL 驱动是否注册了，可以打开注册表 计算机\HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\Null 是否存在。如果不存在，则可以使用下面的文件 https://dldir1.qq.com/WechatWebDev/test/null.reg，注册后，可以在 cmd （使用管理员权限打开）输入 sc start null 查看表现，如果能正常启动则无需下一步

3.如果出现 StartService 失败 则需要考虑是 NULL 驱动的问题

4.如果出现 Windows 无法验证此文件的数字签名 则可以先关闭驱动强制签名，参考外面搜索的 解决方案

3. Windows 打开工具项目窗口卡死

表现: 可以正常安装工具和打开项目列表页窗口，但点击打开某个项目窗口的时候会发现工具卡在初始化页面，然后底部栏显示 loading all files 流程



问题原因：存在几种出现情况：通常是用户设置了系统变量导致

解决办法：该问题通常可以先通过菜单点击 菜单 -> 微信开发者工具 -> 调试 -> 调试微信开发者工具，看看打开的调试面板弹窗console 面板的错误信息。

1. 如果调试面板出现报错信息 --openssl-legacy-provider is not allowed in NODE_OPTIONS ，这个参数是 node17+ 版本才支持，目前工具node 版本最高为16+。无必要可去除该参数设置

1. 出现报错信息 stderr: Warning: Ignoring extra certs from XXX ，可能因为设置不存在的盘符文件夹导致在文件列表获取时启动的 Node.js 进程读取不到导致报错因为用户设置了 NODE_EXTRA_CA_CERTS 环境变量

案例：https://developers.weixin.qq.com/community/develop/doc/000aac41d98e684ab6b2481c46b800

4. Windows 工具图标展示不到的问题

表现：遇到这个问题，通常工具大部分的 svg 图标会展示不了

问题原因：这种问题通常是电脑注册表对于 svg 的 Content Type 类型不支持导致

解决办法：此时可以打开 注册表 找到 计算机\HKEY_CLASSES_ROOT\.svg。看看此时的 Content Type 的数据，如果不是 image/svg+xml 的话需要修改下，然后重启工具看看。

5. Mac 13-14 工具打开不了立即闪退问题 (signal: trace/BPT trap)

表现：mac 点击工具启动会出现立即闪退，，此时需要看看工具日志信息 ~/Library/Application\ Support/微信开发者工具/50a7d9210159a32f006158795f893857/WeappLog/launch.log 如果出现 类似这样的日志 signal: trace/BPT trap 的日志

问题原因：这种问题是 mac 系统 SIP 关闭导致工具首次启动无法完整打开，可以通过终端输入 csrutil status 查看是否正常开启 了 SIP

解决办法：如果没有得到预期的 System Integrity Protection status: enabled., 可输入 csrutil enable 开启 SIP 并且重启电脑和工具看看

6. Mac 工具启动在系统菜单能看到，但没有显示工具

表现：mac 点击工具启动在系统菜单能看到启动了，但没有显示工具。此时需要看看工具日志信息 ~/Library/Application\ Support/微信开发者工具/50a7d9210159a32f006158795f893857/WeappLog/error.log.

问题原因: 如果出现 类似下面这样的日志 Network service crash， HTTP status 412 的日志 ，可以考虑是系统侧网络设置代理，导致 web-proxy 走不通 工具运行失败。

解决方案： 此时可以看看自身的网络代理情况。尝试走其他网络方式启动

其他问题可通过咨询解决

若上述案例无法解决，可加入下面的反馈群，进行问题反馈。反馈前，可以先通过打开 菜单 -> 微信开发者工具 -> 调试 -> 调试微信开发者工具，看看有无具体报错信息。

可以加入下面的反馈群进行问题反馈。