必须先开启手机开发者模式、USB调试及“仅充电时允许USB调试”，并设为文件传输模式，再安装厂商驱动，用adb devices确认设备识别，最后在HBuilderX中运行到Android App基座。
要在HBuilderX里把刚写好的uni-app项目直接跑在安卓手机上调试，必须先让电脑能“认出”你的手机——这一步卡住的人最多，不是驱动没装好，就是USB调试开关藏得太深，或者华为手机在“仅充电”模式下偷偷关掉了ADB权限。
开启手机开发者模式和USB调试
这一步不做对，后面全白搭。华为、小米、OPPO等主流安卓机逻辑一致，但入口位置有差异。
进入手机【设置】→ 滑动到底部或搜索“关于手机” → 找到“版本号”或“软件信息”里的“版本号” → 连续点击7次，直到弹出“您已处于开发者模式”提示（部分HarmonyOS 4.0机型需输入PIN码并重启）。
返回设置主界面，找到新出现的【开发人员选项】（可能在“系统和更新”子菜单里，也可能直接挂在设置底部）→ 进入后打开【USB调试】开关。
重点来了：华为HarmonyOS 3.0+机型必须额外打开【仅充电时允许USB调试】（名称可能显示为“USB调试（安全设置）”），否则即使数据线连着、USB调试开着，HBuilderX也始终显示“未检测到设备”。这个开关不打开，插再多遍线都没用。
连接手机前，下拉通知栏确认USB连接方式不是“仅充电”，要选“文件传输”或“MTP”——有些手机插上线后默认是充电模式，必须手动切换，否则ADB通道不通。
电脑端驱动与HBuilderX识别准备
Windows电脑首次连接安卓手机，大概率需要安装厂商专用驱动。华为用户去华为官网搜“手机助手”下载安装；小米用户装“小米手机助手”；OPPO/vivo建议直接用“ColorOS/iQOO手机助手”。别信第三方通用驱动，容易冲突。
驱动装好后，把手机通过原装数据线连到电脑USB 2.0或3.0接口（避开USB集线器），等待系统托盘弹出“正在安装设备驱动”的提示，几秒后消失即表示驱动就绪。
打开HBuilderX → 点击顶部菜单【运行】→【运行到手机或模拟器】→ 等待设备列表刷新。如果30秒内没出现你手机的型号名，不要急着点刷新，先看下一步。
按 Ctrl+Shift+P 打开命令面板 → 输入“adb devices”并回车 → 观察输出结果：若显示一串字符加“device”，说明ADB已通；若为空或显示“offline”，说明USB调试没生效或驱动异常。
运行项目到真机
第一步：确保HBuilderX中已打开你要调试的uni-app项目，且代码无语法错误（保存一下，Ctrl+S）。
第二步：点击顶部菜单【运行】→【运行到Android App基座】→ 在弹出的设备列表中，勾选你的手机型号（如显示多个设备，选带“device”状态的那个）。
第三步：HBuilderX会自动下载并安装“HBuilder运行助手”App（首次运行必装）→ 手机弹出安装提示时，点【允许安装】→ 安装完成后自动启动调试基座。
第四步：项目代码编译打包完成，手机屏幕立刻亮起并运行当前页面。此时修改代码保存，手机端会热更新（需HBuilderX设置中开启“启用热更新”）。
注意：同一个手机同一时间只能运行一个HBuilderX项目，后一次运行会覆盖前一次。如果手机端黑屏或白屏，回到手机桌面，手动点开“HBuilder运行助手”，再点“启动调试”即可恢复。
