连不上手机八成因USB调试和文件传输模式未同时开启：需进开发者模式（连续点版本号7次）、开USB调试及安全设置、手动选“文件传输”（MTP）模式，缺一不可。
连不上手机，八成不是 HBuilderX 有问题，而是 USB 调试和文件传输模式没同时开对——缺一不可。
Android 手机连不上 HBuilderX 的真实原因
“未检测到设备”不是报错，是结果。背后通常卡在三个地方：
- 手机没进开发者模式：设置 → 关于手机 → 连续点“版本号”7次（MIUI 在“我的设备”，HarmonyOS 在“系统和更新”）
- 进了开发者模式但没开“USB 调试”或“USB 调试（安全设置）”（部分华为/小米要求勾选后者）
- USB 连接后通知栏没手动切到“文件传输”（MTP）——仅充电模式下，
adb devices列表为空，HBuilderX 根本推不了基座 APK
Windows 识别失败时，别急着重装驱动；先去 HBuilderX/plugins/launcher-tools/tools/adbs/adb.exe 手动填入 ADB 路径，再试运行。
必须用自定义基座的几个信号
只要代码里出现以下任意一项，标准 HBuilder 基座就直接失效：
- 调用了
uni.getProvider（比如扫码、蓝牙、地图） - 用了
plus.***API（如plus.webview、plus.bluetooth） - 集成了 uniPush、微信登录、原生插件（哪怕只引入了插件包）
此时“运行到安卓 App 基座”按钮灰掉，或真机上白屏/功能无响应。必须走自定义基座流程：工具 → 插件安装 → 确保已装“App真机运行”和“App开发版SDK” → 运行 → 制作自定义基座 → 填写包名、.keystore 路径（路径不能含中文或空格）、别名、密码 → 提交云端打包。
chrome://inspect 调试 WebView 失败的硬门槛
想在 Chrome 里看 Network、打断点、改样式？三个条件少一个都不行：
- App 必须是自定义基座（标准基座默认禁用调试）
- 代码中显式启用：
plus.webview.getCurrentWebview().setStyle({ debug: true })，建议放在App.vue的onLaunch里 - 手机弹出“允许 USB 调试”提示时，必须点“确定”并勾选“始终允许”——不点，
chrome://inspect设备列表永远为空
配好后，在 Chrome 地址栏输入 chrome://inspect，稍等几秒，目标页面才会出现在“Remote Target”下。
无线调试比有线更脆，但能避开线材问题
如果反复换线、换口、重装驱动仍连不上，可切无线方式（HBuilderX 4.71+ 支持可视化操作）：
- 手机端：设置 → 开发者选项 → 开启“无线调试”，选择“配对码配对”或“二维码配对”
- HBuilderX：运行 → 无线连接 → 选对应配对方式 → 扫码或输入6位配对码
- 注意：“无线调试”不是常驻开关，闲置几分钟就会自动关闭，下次要用得重新开
无线调试成功后，设备会出现在运行设备列表里，后续操作和有线完全一致。但首次配对失败率高，建议优先搞定有线——它才是最稳的基线。
