鸿蒙开发无线调试

欢迎到专业群（ HBuilderX技术交流群 ） 咨询，群中有相关专业的管理员和群友。

在 HBuilderX 里给鸿蒙（HarmonyOS）设备做「无线调试」可以分两步走：

1. 让 PC 端先通过 hdc 无线识别设备；
2. 在 HBuilderX 里把设备当成普通真机来运行 / 调试。

下面给出可落地的操作步骤，全部来自官方文档与社区验证过的做法，可直接照做。

一、先用 hdc 把设备无线连上 PC

1. 手机端
   • 设置 → 系统和更新 → 开发者选项 → 打开“USB 调试”和“无线调试”。
   • 在“无线调试”页面里点击“配对设备”，会弹出 ip:port 和配对码。

2. PC 端（命令行一次即可，后续不用再插线）

   # 第一次先用线连上，确保 hdc 能找到设备  
   hdc tmode usb  
   # 让手机监听 5555 端口（也可换成别的）  
   hdc tcpip 5555  
   # 拔掉数据线  
   hdc connect 手机IP:5555  

   成功后 hdc list targets 能看到 IP:5555 的设备，即代表 PC 端已无线识别。

二、在 HBuilderX 里使用这台无线设备

1. 打开 HBuilderX → 运行 → 运行到手机或模拟器 → 刷新设备列表。
2. 列表里会出现刚才 IP:5555 的那台鸿蒙设备，选中即可像 USB 一样「运行」「调试」「热重载」。

三、常见问题排查
• 如果刷新不到：
– 确认 PC 和手机在同一局域网；
– 确认手机“无线调试”保持开启（部分机型锁屏后会自动关闭，需要重新开启或把休眠策略设为“永不”）；
– 防火墙放行 5555 端口。

• 如果 hdc 命令找不到：
– HBuilderX 安装目录下自带 hdc，把 HBuilderX/plugins/hdc 加到系统 PATH 即可。

• 想调试 WebView：
无线连接成功后，继续按官方文档 鸿蒙开启 chrome 调试 做端口转发即可，步骤与 USB 完全一致，不再赘述。

这样即可彻底摆脱数据线，日常开发、调试、热重载全部走无线。