作为天天用Flutter撸App的老玩家，WiFi连ADB绝对是提升调试效率的神器——再也不用被USB线缠得像个粽子了。下面先给你讲标准操作流程，再把我踩过的坑和排错方法全掏给你。

一、正常连接步骤（必看前置条件） #

首先得确保这几点：

• 你的Android设备和电脑连在同一个WiFi网络下（注意：别一个连2.4G一个连5G，有些路由器会隔离频段）
• 设备上已经开启USB调试（路径：设置 → 关于手机 → 连续点击“版本号”开启开发者选项，然后回到设置找到开发者选项 → 打开USB调试）
• 电脑上已经配置好ADB环境（Flutter SDK自带ADB，只要你能正常跑flutter doctor基本没问题）

接下来按步骤操作：

1. 先用USB线把设备连到电脑上，打开终端执行：

   adb devices
   

   看到设备列表里出现你的设备（比如一串字母数字加device状态），说明USB连接正常。
2. 开启设备的ADB TCP/IP模式，执行：

   adb tcpip 5555
   

   终端会提示“restarting in TCP mode port: 5555”，这就成了。
3. 拔掉USB线，找到你的设备IP地址：
   • 方法1：设备端打开「设置 → 关于手机 → 状态信息 → IP地址」
   • 方法2：刚才USB还连着的时候，执行adb shell ip addr show wlan0，找inet后面的IP（比如192.168.3.105）
4. 用WiFi连接设备，执行：

   adb connect 192.168.3.105:5555
   

   终端提示“connected to 192.168.3.105:5555”就成功了，再跑一遍adb devices确认设备状态是device。

二、常见错误排查方案 #

1. adb devices没显示设备（USB阶段就卡壳） #

• 检查设备的USB调试有没有真的开着，有时候重启设备后会自动关闭，得重新开
• 看看电脑有没有装对应设备的驱动（比如小米/华为的官方驱动，或者用Android Studio的SDK Manager装Google USB Driver）
• 确认ADB环境变量配置正确：终端跑adb version能显示版本号就没问题，不行就把Flutter SDK里的platform-tools路径加到系统环境变量里
• 设备上弹出“允许此设备调试吗？”的时候，一定要勾选“始终允许”然后点确定

2. adb connect IP:5555提示“Connection refused”或“unable to connect” #

• 先确认设备和电脑在同一个WiFi：电脑ping设备IP试试，ping不通就是网络问题，检查路由器设置或者换个WiFi
• 重新执行adb tcpip 5555：有时候拔掉USB太快，设备还没切换到TCP模式，再插回USB重新跑一遍这个命令，等提示重启成功再拔线
• 换个端口试试：5555端口可能被其他程序占用，比如adb tcpip 5556然后adb connect IP:5556
• 检查防火墙/杀毒软件：Windows的防火墙或者360这类软件可能拦截了ADB的网络连接，暂时关掉试试
• 重启ADB服务：终端执行adb kill-server，再执行adb start-server，然后重新连接

3. 连接成功后很快断开，或者adb devices显示offline #

• 检查设备是不是休眠了：开发者选项里打开“保持唤醒状态”，避免设备锁屏后断开连接
• 试试重启设备和电脑：有时候就是玄学问题，重启一下全解决
• 检查WiFi信号：信号太差会导致连接不稳定，靠近路由器试试

三、额外小技巧 #

• 如果经常连同一个设备，可以把IP地址记下来，下次直接连不用再查
• 有些设备支持无线ADB调试（比如Android 11+），可以直接在开发者选项里开启“无线调试”，不用先插USB，直接扫二维码或者输入IP+端口连接，更方便

内容的提问来源于stack exchange，提问作者TheLastGimbus