在 Windows 环境下使用 HBuilderX 调试 Android 应用时，最关键的两个要素是：
- adb.exe 路径配置
- 模拟器端口配置
本文将这两个配置放在一起讲解，让你能够快速完成调试环境设置。
1. 一张图看懂整体流程
[找到 adb.exe ] --> [配置到 HBuilderX ] --> [adb devices 查看端口 ]
| |
| ↓
+-->（可选：加到系统环境变量） [配置模拟器端口到 HBuilderX ]
只要 adb 路径正确 + 端口匹配正确，HBuilderX 就能识别模拟器。
2. 配置 adb 路径 + 模拟器端口（并列说明）
① 在 HBuilderX 中设置 ADB 路径
进入：
运行 -> 运行到手机或模拟器 -> adb 路径设置
将模拟器或 Android SDK 的 adb.exe 填入，例如：
C:\Android\platform-tools\adb.exe
或者模拟器自带的 adb，例如联想模拟器：
C:\Program Files\LenovoSimulator\adb.exe
② 同时配置模拟器端口（与 adb 一起配）
同一位置即可设置模拟器端口：
运行 -> 运行到手机或模拟器 -> Android 模拟器端口
填入你 adb devices 中看到的端口，例如：
11509
记住：端口必须与 adb devices 输出一致，否则不会识别模拟器。
3. 如何快速找到 adb.exe 与端口？（关键部分）
（1）找到 adb.exe
你可以从以下位置找到：
| 来源 | adb.exe 位置示例 |
|---|---|
| Android SDK | C:\Android\platform-tools\adb.exe |
| 联想模拟器 | 安装目录下查找 adb.exe |
| 夜神、MuMu、雷电等模拟器 | 安装目录通常包含 adb.exe |
如果找不到，直接搜索：
在模拟器安装目录搜索：adb.exe
（2）查看模拟器端口
CMD 或 PowerShell 执行：
adb devices
如果看到类似：
127.0.0.1:11509 device
说明：
- 设备 IP：127.0.0.1（本机）
- 端口号：11509
- 状态：device（已连接）
这个端口号就是你要配置给 HBuilderX 的端口。
4. ADB 故障排查（与端口一起操作）
为了让「端口 + ADB」统一操作，这里整理成连贯流程：
步骤 1：确保 adb 可用
adb devices
若提示找不到 adb → adb 路径配置错误 → 重新设置到 HBuilderX。
步骤 2：重启 adb 服务（若无法识别设备）
adb kill-server # 关闭 adb
adb start-server # 重启 adb
解释：
重启 adb 可以解决 80% 的连接失败。
步骤 3：手动连接模拟器端口
adb connect 127.0.0.1:11509
作用：
- 强制让 adb 连接模拟器端口
- 避免模拟器未自动注册到 adb 列表的问题
再次查看：
adb devices
应看到：
127.0.0.1:11509 device
步骤 4：把端口 + adb 地址一起配到 HBuilderX
adb 路径：
C:\Program Files\LenovoSimulator\adb.exe
模拟器端口：
11509
HBuilderX 立刻能识别模拟器。
5. 完整简明总结（保证一看就懂）
✔ 配 adb.exe
HBuilderX → 运行 → adb 路径设置
✔ 配模拟器端口
HBuilderX → 运行 → Android 模拟器端口
✔ 用 adb devices 查端口
如看到：127.0.0.1:11509 device → 配 11509 即可
✔ 无法识别设备？
执行：
adb kill-server
adb start-server
adb connect 127.0.0.1:11509
本文部分内容借助 AI 辅助生成，并由作者整理审核。
