必须启用无线调试连接，使HarmonyOS应用通过Wi-Fi在真机上实现安装HAP、推送资源、读取HiLog、断点调试等全功能；需满足开发者选项开启、同Wi-Fi网络、DevEco Studio≥5.3.0三大前提。
在HarmonyOS开发中，需要让应用直接在真机上运行并实时查看日志、断点调试、热重载，但又不想被USB线缠住手腕、不敢挪动手机、怕接口松动导致调试中断——这时必须启用无线调试连接，它能让设备与DevEco Studio通过同一Wi-Fi完成全功能调试，包括安装HAP、推送资源、读取HiLog、触发断点。
确认前置条件是否到位
先别急着点“连接”，有三个硬性前提缺一不可：设备已开启开发者选项并启用无线调试；电脑和真机连在同一Wi-Fi下（不能是访客网络或企业隔离网段）；DevEco Studio版本不低于5.3.0（推荐6.0.0+）。
打开手机“设置→关于手机→软件版本”，连续点击7次，出现“您现在是开发者”提示后重启生效。再进入“设置→系统→开发者选项”，确保【USB调试】和【无线调试】两个开关都已打开——很多人只开无线调试却忘了USB调试也必须开启，否则hdc服务无法初始化。
检查Wi-Fi：电脑和手机的IP地址前三位必须一致（如192.168.1.x），用cmd或终端执行ipconfig/ifconfig验证；若手机显示的是172.16.x.x或10.x.x.x网段，说明连错了热点或路由器启用了多子网隔离。
获取设备端IP与端口
进入“设置→系统→开发者选项”，找到“无线调试”条目（HarmonyOS 4.0+可能显示为“通过WLAN调试”）。点击开启后，界面下方会立即显示一行信息，格式为192.168.1.105:38241——这就是你要抄下来的完整地址+端口。
注意：这个端口每次重启无线调试开关都会变化，不是固定5555；如果没显示，尝试关闭再重开一次开关，或重启设备开发者选项服务。
两种连接方式任选其一
方法一：用DevEco Studio图形界面连接
点击顶部菜单栏Tools → IP Connection → 在Address栏粘贴刚才记下的IP:端口（例如192.168.1.105:38241）→ Name可填“Mate60-Pro-WiFi”便于识别 → 点击绿色连接箭头图标。
方法二：用命令行强制直连
打开终端（Windows用CMD/PowerShell，macOS/Linux用Terminal），输入：
hdc tconn 192.168.1.105:38241
回车后若返回Connect OK，说明底层通道已通。这步绕过了IDE界面层，适合界面连接失败时排查问题。
无论哪种方式，连接成功后Device Manager里会出现该设备，状态显示online，且名称后缀带“(WiFi)”标识。
验证连接是否真正可用
第一步：在终端执行 hdc list targets，输出中必须包含你刚连的IP:端口，且没有error字样。
第二步：在DevEco Studio中点击Run → Run ‘entry’，选择刚上线的WiFi设备作为目标 → 观察构建日志是否出现“Installing on device…”而非报错“Device not found”。
第三步：启动应用后，在Logcat窗口输入关键词hiLog，确认能实时刷出设备端打印的日志——如果日志为空或延迟超3秒，说明TCP通道未完全建立，需重启hdc服务：
hdc kill → hdc start，再重试连接。
