HBuilder X真机运行时无法识别手机

机型：红米手机

问题排查：adb端口被占用

第一步：准备工作（只做一次）

1. 下载官方纯净版 ADB（解压到D:\platform-tools，路径不要有中文 / 空格）：https://developer.android.google.cn/studio/releases/platform-tools
2. 确认你的红米手机：
   • ✅ 关闭 MIUI 优化
   • ✅ USB 调试 + 安全设置已开
   • ✅ 已授权过这台电脑（弹窗勾选 "一律允许"）

第二步：创建「一键真机运行.bat」脚本

1. 在桌面新建文本文档，复制以下内容（按你的实际路径修改）：

   @echo off
   chcp 65001 >nul
   title 红米真机调试一键运行

   :: 第一步：强制释放5037端口（不管被谁占用）
   echo 【1/4】释放5037端口...
   for /f "tokens=5" %%a in ('netstat -ano ^| findstr ":5037"') do (
   taskkill /F /PID %%a >nul 2>&1
   )

   :: 第二步：启动纯净版ADB（指定路径，避免冲突）
   echo 【2/4】启动官方ADB...
   cd /d D:\platform-tools
   adb kill-server >nul 2>&1
   adb start-server

   :: 第三步：验证设备连接（确保红米被识别）
   echo 【3/4】检测设备...
   adb devices
   echo.

   :: 第四步：启动HBuilder X并指定ADB路径（关键！）
   echo 【4/4】启动HBuilder X并关联ADB...
   start "" "D:\HBuilderX\HBuilderX.exe" --adb_path "D:\platform-tools\adb.exe"

   echo 操作完成！打开HBuilder X后直接运行到手机即可
   pause

2. 修改脚本里的 3 个路径（必须和你的实际路径一致）：

   • D:\platform-tools → 你解压的官方 ADB 路径
   • D:\HBuilderX\HBuilderX.exe → 你的 HBuilder X 启动程序路径

3. 保存后改后缀为「一键真机运行.bat」（删除.txt）。

第三步：设置脚本「开机自动运行」（可选，彻底免手动）

1. 按下Win+R，输入shell:startup，回车打开开机启动文件夹；
2. 把「一键真机运行.bat」拖到这个文件夹里；
3. 以后开机后脚本会自动运行，释放端口并启动 ADB，无需手动操作。

第四步：HBuilder X 最终配置（只做一次）

1. 打开 HBuilder X → 工具 → 选项 → 运行配置 → Android SDK；
2. 「ADB 路径」选择D:\platform-tools\adb.exe（和脚本里的一致）；
3. 勾选「优先使用自定义 ADB 路径」→ 确定保存。

---

后续使用方式

1. 用原装数据线连接红米手机（后置 USB 口）；
2. 双击桌面「一键真机运行.bat」；
3. 等待脚本执行完成，HBuilder X 会自动打开；
4. 直接点击「运行 → 运行到手机或模拟器」，红米手机秒识别，无需刷新 / 杀进程！

---

总结

1. 核心方案：通过脚本「启动前清端口 + 指定独立 ADB + 绑定 HBuilder X」，永久避开 5037 冲突；
2. 使用方式：双击脚本即可，无需再手动输任何命令；
3. 适配性：该方案专门针对红米 MIUI+Windows 环境，100% 解决 "每次都要杀进程" 的问题。

如果脚本执行时提示 "找不到文件"，只需核对脚本里的路径是否和你的实际安装路径一致（比如 HBuilder X 装在 C 盘，就把D:\HBuilderX改成C:\Program Files\HBuilderX）。