HBuilderX 无法启动微信小程序开发者工具的排查与解决

在使用 uni-app 开发跨端应用时，通过 HBuilderX 点击“运行 -> 运行到小程序模拟器 -> 微信开发者工具”后，经常会遇到提示：“无法启动微信开发者工具” 或控制台无响应卡死。这通常是由于工具路径未配置或微信开发者工具的“安全服务端口”未开启所致。

一、 检查并配置小程序开发者工具路径

1. 在 HBuilderX 顶部菜单栏中，点击 工具 (Tools) -> 设置 (Settings)；
2. 在左侧导航中选择 源码视图 或 运行配置；
3. 找到 微信开发者工具路径 输入项；
4. 点击浏览或手动填入本地 cli.bat 所在目录（例如：C:/Program Files (x86)/Tencent/微信web开发者工具）；

二、 开启微信开发者工具的“服务端口”（最关键步骤）

微信开发者工具出于安全防护考虑，默认关闭了外部 IDE 调用的命令行与 HTTP 端口：

1. 手动启动打开 微信开发者工具；
2. 点击顶部菜单栏的 设置 (Settings) -> 安全设置 (Security Settings)；
3. 找到 服务端口 (Service Port) 选项，将其开关切换为 「开启」；
4. （可选）勾选“允许外部工具获取登录票据”；
5. 关闭微信开发者工具，返回 HBuilderX 重新点击运行，即可实现自动编译并唤醒微信模拟器！