一、问题现象
- 手机已开启 USB 调试 模式，并用数据线连接电脑。
- 进入 HBuilderX 自带的 ADB 目录下（例如：
HBuilderX\plugins\launcher-tools\tools\adbs），在命令行执行.\adb.exe devices能够正常输出设备序列号：
text
List of devices attached
P2PAN8990XFB25B0353 device- 但回到 HBuilderX 中，点击顶部菜单 **
运行->运行到手机或模拟器**时，下拉列表中始终为空，或者提示"未识别到设备"。
二、排查思路与分析
当 adb devices 能查出 device 状态时，说明以下几点完全正常，无需额外操心：
- ❌ 不是数据线问题（已正常通信）
- ❌ 不是电脑缺少驱动问题
- ❌ 不是手机没开"USB调试"或没给 RSA 电脑授权问题
既然底层 ADB 已经拿到了设备，问题必出在 HBuilderX 与 ADB 的对接机制 或 手机端安装权限 上。
三、完整排查与解决步骤
步骤 1：排查国产手机的"USB安装"权限（常见隐蔽坑）
小米、华为、OPPO、vivo 等国产手机，如果只开启了"USB 调试"，但没开启"USB 安装"，HBuilderX 检测到无法静默推送基座 App 时，会在界面上直接屏蔽该设备。
- 小米 / 红米 ：开发者选项中，除了"USB 调试"，必须同时开启 "USB 安装" 和 "USB 调试（安全设置）"（开启安全设置时可能需要插卡验证）。
- 华为 / 荣耀 ：开发者选项中，开启 "允许通过 USB 安装应用"。
- OPPO / vivo / Realme ：开发者选项中，开启 "禁止权限监控" 或 "允许 USB 安装"。
步骤 2：重置 ADB 服务与清除残留进程
有时候后台有第三方软件（如微信开发者工具、各种手机助手）抢占了 ADB 端口，或者 HBuilderX 内部的 ADB 状态未刷新。
- 打开任务管理器（
Ctrl + Shift + Esc），结束所有名为adb.exe的进程。 - 回到 HBuilderX，点击顶部菜单：**
运行->运行到手机或模拟器->重置 ADB 服务**。 - 重新点击
重新扫描手机。
步骤 3：【核心解法】手动指定 HBuilderX 的 ADB 路径
如果上述步骤做完依然识别不到，说明 HBuilderX 内置的 ADB 自动探测/检索逻辑在当前系统环境下发生了阻塞或误判。
解决方案：跳过自动探测，显式指定绝对路径。
- 点击 HBuilderX 顶部菜单：**
工具->设置**。 - 切换到
源码/运行设置（或运行配置）。 - 找到 "Android设备运行配置" 区域中的 "adb路径"。
- 填入你刚才终端测试成功的
adb.exe绝对路径，例如：
text
D:\develop_software\HBuild\HBuilderX\plugins\launcher-tools\tools\adbs\adb.exe- 保存配置，彻底重启 HBuilderX。
四、总结
- 判断标准 ：先用终端调用
adb.exe devices。能查到设备说明硬件和驱动无误；查不到设备则优先检查数据线（是否仅充电）、USB 调试开关和电脑驱动。 - 终极一招 ：当终端能查到、HBuilderX 却查不到时，直接在 HBuilderX 的"Android设备运行配置"中手动填入
adb.exe的绝对路径，即可强制解决识不出设备的问题。