- 开发者工具启动异常自助解决方案
- 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 驱动的问题, 需要考虑找个对应的 null.sys 放到 C:\Windows\System32\drivers\ 这个目录下。这里提供一个 sys https://dldir1.qq.com/WechatWebDev/test/null.sys
4.如果出现 Windows 无法验证此文件的数字签名 则可以先关闭驱动强制签名，参考外面搜索的
- 解决方案
- win11和 win10 禁用驱动程序强制签名
3. Windows 打开工具项目窗口卡死
表现: 可以正常安装工具和打开项目列表页窗口，但点击打开某个项目窗口的时候会发现工具卡在初始化页面，然后底部栏显示 loading all files 流程
问题原因：存在几种出现情况：通常是用户设置了系统变量导致
解决办法：该问题通常可以先通过菜单点击 菜单 -> 微信开发者工具 -> 调试 -> 调试微信开发者工具，看看打开的调试面板弹窗console 面板的错误信息。
- 如果调试面板出现报错信息
--openssl-legacy-provider is not allowed in NODE_OPTIONS，这个参数是 node17+ 版本才支持，目前工具node 版本最高为16+。无必要可去除该参数设置
- 出现报错信息
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 走不通 工具运行失败。
解决方案： 此时可以看看自身的网络代理情况。尝试走其他网络方式启动
其他问题可通过咨询解决
若上述案例无法解决，可加入下面的反馈群，进行问题反馈。反馈前，可以先通过打开 菜单 -> 微信开发者工具 -> 调试 -> 调试微信开发者工具，看看有无具体报错信息。
可以加入下面的反馈群进行问题反馈。
