简介这份PDF资源聚焦Android开发中的无线调试技巧面向已掌握基础ADB操作、希望摆脱数据线束缚的Android开发者与测试人员重点解决USB连接受限、频繁插拔磨损设备等问题。全文围绕Android Studio的Android WIFI ADB插件展开涵盖插件安装、重启后在工具栏定位入口、用数据线验证设备日志输出、确保手机与电脑处于同一WiFi、点击图标建立无线连接直至拔线独立调试的完整流程并提醒网络不稳定、速度波动与安全关闭等注意事项属可直接照做的实操笔记。资源为1个PDF文件压缩包约187KB体量轻便适合快速浏览与随查随用。目前已有2737人学习下载说明该技巧在开发社区具备较高的实用关注度可为日常调试与远程联调提供省时省力的参考。1. Android WIFI ADB 无线调试数据线之外的第二条通路反直觉的是无线调试的起点是有线。必须先靠 USB 连一次让 adb 完成握手并切到 TCP/IP 模式之后的adb connect才有目标可谈。很多教程把这一步略过新手拔了线才发现device offline。Android WIFI ADB 插件的价值就是把adb tcpip、adb connect、adb disconnect这几条命令和 IP 查询封装成一个工具栏按钮省去手动敲命令。它适合手机架在支架上够不着 USB 口、频繁切换设备、想边调试边充电的人。但别指望它替代 USB性能分析、高频 logcat、刷机这类场景有线更稳。下面把原理、插件路径、命令行路径、断连排查和脚本化收尾串一遍都是能直接抄的操作。2. ADB 无线调试的端口监听与握手原理2.1 adb server 与设备端 adbd 的角色分工当终端里敲下adb devices实际发生的是PC 上后台常驻的 adb server 通过本地 5037 端口接收客户端请求再与设备端的 adbd 进程通信。默认走 USB 通道数据线既供电又传数据。所谓“无线调试”是把这条通信通道从 USB 换到 TCP/IP让 adb server 用 IP 加端口寻址设备。设备端的 adbd 是运行在手机上的守护进程正常情况下只监听 USB。执行adb tcpip 5555相当于告诉 adbd重启进程、切到 TCP/IP 模式并在 5555 端口监听连接请求。这里有个容易被忽略的点——这条命令本身是通过 USB 下发到 adbd 的所以 USB 必须在线。很多教程把“先插线”当成可选项其实它是硬性前提没有第一步后面的 connect 没有目标可谈。从架构角度看adb 是 C/S 结构PC 上的 adb server 是服务端客户端是adb命令行本身设备上的 adbd 是被控端。无线模式下服务端和被控端之间走的是一条标准 TCP 连接。理解这一层后面遇到的超时、refused、drop 都能对症定位。提示5555 是 adbd 的默认监听端口可替换成其他未被占用的端口排查端口冲突时会用到。2.2 从 adb tcpip 到 adb connect 的握手细节标准流程分三步顺序不能颠倒# 1. 确认设备已通过 USB 被识别状态应为 device adb devices # 2. 让设备端 adbd 切换到 TCP/IP 模式并监听 5555 adb tcpip 5555 # 3. 断开 USB用手机当前 IP 连接 adb connect 192.168.1.100:5555第 1 步输出中的device状态是关键出现unauthorized或offline都不能往下走。第 2 步执行后会返回restarting in TCP mode port: 5555部分机型这时 USB 连接会短暂中断属正常现象。第 3 步成功时返回connected to 192.168.1.100:5555再跑一次adb devices就能看到一条带 IP 的记录。失败最常见的两个原因一是 IP 写错二是手机和 PC 不在同一网段。同一网段是硬条件IP 通常在 192.168.x.x 或 10.0.x.x 之间前缀必须一致。还有一个隐形杀手是路由器的 AP 隔离公司 Wi-Fi 和公共热点常默认开启开了之后同一 SSID 下的设备互不可见表现就是connection refused或者一直超时。家用路由器可以在无线设置里关掉这个选项。注意手机上显示的 IP 有时候是 IPv6 地址adb 无线调试走的是 IPv4认准ip -f inet过滤出来的那条。2.3 插件按钮背后等价于哪几条命令Android WIFI ADB 插件做的拆分并不神秘点击工具栏按钮时大致执行了这几步插件动作等价 adb 命令说明读取设备 IPadb shell ip -f inet addr show wlan0从 wlan0 取 IPv4切换无线模式adb tcpip 5555固定端口插件一般用默认值建立连接adb connect ip:5555成功后写入 adb 设备列表断开连接adb disconnect ip:5555掉线或切换网络时用知道这个等价关系最大的好处是排错时能分层判断插件按钮不响应先手动敲这三条命令命令能通说明是插件问题命令也不通就回去查 USB、网络和 adbd 状态。抓取设备 IP 也可以用adb shell ifconfig wlan0但 Android 10 之后部分 ROM 已经移除ifconfig所以更推荐ip addr show wlan0或ip -f inet addr show wlan0。3. Android Studio 插件与 adb 命令行双路径实操3.1 Android WIFI ADB 插件安装与工具栏还原在 Android Studio 里走 Settings → Plugins → Marketplace搜索 Android WIFI ADB安装后重启 IDE。重启完成后顶部工具栏应该会出现一个小手机带 Wi-Fi 波形的图标。如果没出现可以右键工具栏空白处选择 Customize Menus and Toolbars或者从 File → Settings → Appearance Behavior → Menus and Toolbars 里手动把它拖出来。老一代的 adb wifi 插件是另一条路需要手机端另外装一个配合 App通过那个 App 开启监听端口再回 AS 里手动输入 IP。多了一步配对稳定性也一般所以现在基本被 Android WIFI ADB 替代。相比之下新插件把查 IP、切模式、连设备三件事合并成一次点击能省下不少敲命令的时间。插件路径的短板也是实打实的——它同样需要先检测到 USB 在线设备才能拿到 IP 切 tcpip。所以“插线”这一步谁都绕不过去。有人以为装了插件就能完全没有数据线其实第一次连接始终需要 USB 参与。3.2 手动 adb tcpip adb connect 完整步骤不想装插件、或者用命令行工具、CI 环境里跑自动化手动路径更通用# 确认 adb 版本新版对无线支持和调试体验更好 adb version # 列出当前 USB 设备-l 会带上型号和 transport_id adb devices -l # 取出设备 wlan 的 IPv4 地址 adb shell ip -f inet addr show wlan0 # 切到 TCP/IP 模式指定监听端口 adb tcpip 5555 # 用上一步拿到的 IP 连接 adb connect 192.168.1.100:5555 # 拔掉 USB 后再次确认 adb devices逐条解释一下。adb version主要是确认 adb 工具版本太老的 adb 对 Android 11 的无线调试支持不完整。adb devices -l里的-l会打印设备型号、transport_id 等信息多设备场景用来区分目标。adb shell ip -f inet addr show wlan0只过滤 IPv4 地址比ifconfig在 Android 10 以后更可靠。adb tcpip 5555是核心一步括号里的数字是监听端口不写就默认 5555。adb connect成功后logcat、断点、adb install、adb shell全部能照常使用。想断开用adb disconnect 192.168.1.100:5555想彻底关掉无线监听切回 USB插回数据线执行adb usb即可。提示adb tcpip之后不要立即拔线等 12 秒让 adbd 完成重启否则 connect 的成功率会明显下降。3.3 参数取舍与场景对照把常用选项整理成一张表方便按场景挑参数 / 选项常用取值何时改 / 何时用adb tcpip port55555555 被占或公司策略限制时改adb connect ip:portIP:5555端口须与 tcpip 保持一致-s serial序列号或 IP多设备同时在线时指定目标adb -a监听所有网卡从其他主机连本机 adb serveradb -P port5037adb server 端口冲突时改-s和-P是最常用的两个。-s前面已经说过多设备必须带。-P主要在同时跑多套调试环境时出现比如一台机器上既开发又跑自动化测试。adb -a一般不需要除非有从局域网另一台机器连本机 adb server 的需求安全上也建议保持默认。注意端口改过之后adb connect的端口必须跟adb tcpip一致写错端口是connection refused的高频原因。4. 多设备、断线重连与 adb 无线调试常见报错排查4.1 adb devices 输出状态逐项解读adb devices的输出只有几列但每一列都能用来定位问题输出片段含义下一步device正常在线可直接调试unauthorized未授权等待手机端弹窗确认看手机屏幕点“允许”offline连接建立但 adbd 无响应重连或重启 adb server空列表adb server 未识别到设备查 USB、驱动、IPunauthorized常见于换了新电脑、重装系统或者手机恢复出厂设置之后。手机端“USB 调试授权”弹窗如果之前手快点过“拒绝”之后再插线也不会弹得进开发者选项里的“撤销 USB 调试授权”清空记录重新插一次。offline多见于无线连接不稳定路由器短时间丢包后 adb 认为设备还在列表里实际链路已经断了。空列表这一格看似没问题实际上是最难查的一类。USB 下空列表通常是驱动没装好Windows 上的 Google USB Driver 或厂商驱动无线下空列表则要先确认 adb server 是否还在运行。4.2 connection refused 与 timeout 的区分处理两者表现相近成因不一样。connection refused是 TCP 层明确拒绝说明目标 IP 可达但端口没有在监听——常见原因是adb tcpip没执行成功或设备重启后 TCP 模式丢失。timeout是连 IP 都不可达多半是不同网段、AP 隔离或者手机锁屏后 Wi-Fi 进入了省电休眠。排查顺序建议固定成一条链路# 1. 先确认 PC 能不能 ping 到手机 ping -c 2 192.168.1.100 # 2. 重启本地 adb server清掉缓存状态 adb kill-server adb start-server # 3. 断开再重连 adb disconnect 192.168.1.100:5555 adb connect 192.168.1.100:5555 # 4. 仍不通就走一次 USB重新 tcpip adb usb adb tcpip 5555 adb connect 192.168.1.100:5555第 1 步不通问题在网络层跟 adb 无关。第 2 步是很多疑难杂症的通用解法adb server 长时间运行后会缓存失效设备kill-server强制重扫。第 3 步针对离线设备做一次干净重连。第 4 步本质是回到有线再切一次把设备端 adbd 拉回已知状态。提示部分 Android 版本和厂商 ROM 在锁屏后休眠 Wi-Fi开发者选项里保持“不锁定屏幕”或“保持唤醒状态”开着能有效减少掉线。4.3 多设备并行与 -s 指定目标同时连了 USB 设备和无线设备时adb命令会报more than one device/emulator。解决办法是用-s指定# 用设备序列号指定序列号从 adb devices 输出第一列拿 adb -s ABC12345 logcat # 无线设备用 IP:端口 作为序列号 adb -s 192.168.1.100:5555 install app-debug.apk # 批量对多台无线设备执行 for ip in 192.168.1.100 192.168.1.101; do adb -s $ip:5555 shell getprop ro.build.version.release doneadb -s后面的值必须和adb devices第一列完全一致差一个字符都会变成device not found。写脚本时最常见的坑就是忘带-s然后命令随机打到了错误设备上这个坑在同时跑多个 App 的测试环境下尤其危险。另一种隔离手段是给每个设备起独立 adb server用ADB_SERVER_PORT环境变量加adb -P 5038 start-server多套环境互不干扰。配置麻烦、占用端口多一般只有自动化测试框架才会用。5. 无线调试脚本化与稳定重连的落点技巧插件和命令行都能连上以后真正烦人的是掉线后手动重连。把固定 IP 和重连逻辑写进一个小脚本是让无线调试真正可用的收尾动作。手机端把路由器里的 DHCP 绑定打开把手机的 MAC 固定到一个网段内的地址比如 192.168.1.100避免每次换 IP 都要重新查。脚本思路很简单先 ping 一次不通就说明网络掉了通了但 adb 列表里没有就走 connect。#!/usr/bin/env bash # 用法: ./adb-wifi-reconnect.sh 192.168.1.100 5555 IP${1:-192.168.1.100} PORT${2:-5555} # ping 一次判断网络可达性-c 1 发一个包-W 1 超时 1 秒 if ! ping -c 1 -W 1 $IP /dev/null; then echo network unreachable: $IP exit 1 fi # 如果设备已在列表先断开再重连避免脏状态 adb disconnect $IP:$PORT /dev/null 21 adb connect $IP:$PORT # 校验连接状态正常返回 device adb -s $IP:$PORT get-state脚本里ping -c 1 -W 1表示发 1 个包、超时 1 秒够快又不阻塞。adb disconnect先执行是有意为之adb 对同一 IP 重复 connect 时有时会返回成功但实际没连上先断后连更干净。最后get-state正常返回device就说明通了。真机场景里手机重启、Wi-Fi 重连、路由器重启都会让 TCP 模式丢失此时只能插一次 USB 重新adb tcpip。所以更实用的做法是把脚本挂到 shell 别名里掉线时一条命令跑完比手工敲五条命令节省时间。批量设备调试可以再套一层 for 循环把 IP 列表读进变量逐个连。再往前一步可以把adb tcpip 5555的触发点交给 Android Studio 的 Before Launch 任务每次 Run 之前自动跑一次连接脚本。这样即便中途掉线下一次 Run 也会自动恢复把无线调试从“偶尔用用”变成日常主路径。本文还有配套的精品资源点击获取 Android WIFI ADB无线调试：从原理到插件与命令行实操
简介这份PDF资源聚焦Android开发中的无线调试技巧面向已掌握基础ADB操作、希望摆脱数据线束缚的Android开发者与测试人员重点解决USB连接受限、频繁插拔磨损设备等问题。全文围绕Android Studio的Android WIFI ADB插件展开涵盖插件安装、重启后在工具栏定位入口、用数据线验证设备日志输出、确保手机与电脑处于同一WiFi、点击图标建立无线连接直至拔线独立调试的完整流程并提醒网络不稳定、速度波动与安全关闭等注意事项属可直接照做的实操笔记。资源为1个PDF文件压缩包约187KB体量轻便适合快速浏览与随查随用。目前已有2737人学习下载说明该技巧在开发社区具备较高的实用关注度可为日常调试与远程联调提供省时省力的参考。1. Android WIFI ADB 无线调试数据线之外的第二条通路反直觉的是无线调试的起点是有线。必须先靠 USB 连一次让 adb 完成握手并切到 TCP/IP 模式之后的adb connect才有目标可谈。很多教程把这一步略过新手拔了线才发现device offline。Android WIFI ADB 插件的价值就是把adb tcpip、adb connect、adb disconnect这几条命令和 IP 查询封装成一个工具栏按钮省去手动敲命令。它适合手机架在支架上够不着 USB 口、频繁切换设备、想边调试边充电的人。但别指望它替代 USB性能分析、高频 logcat、刷机这类场景有线更稳。下面把原理、插件路径、命令行路径、断连排查和脚本化收尾串一遍都是能直接抄的操作。2. ADB 无线调试的端口监听与握手原理2.1 adb server 与设备端 adbd 的角色分工当终端里敲下adb devices实际发生的是PC 上后台常驻的 adb server 通过本地 5037 端口接收客户端请求再与设备端的 adbd 进程通信。默认走 USB 通道数据线既供电又传数据。所谓“无线调试”是把这条通信通道从 USB 换到 TCP/IP让 adb server 用 IP 加端口寻址设备。设备端的 adbd 是运行在手机上的守护进程正常情况下只监听 USB。执行adb tcpip 5555相当于告诉 adbd重启进程、切到 TCP/IP 模式并在 5555 端口监听连接请求。这里有个容易被忽略的点——这条命令本身是通过 USB 下发到 adbd 的所以 USB 必须在线。很多教程把“先插线”当成可选项其实它是硬性前提没有第一步后面的 connect 没有目标可谈。从架构角度看adb 是 C/S 结构PC 上的 adb server 是服务端客户端是adb命令行本身设备上的 adbd 是被控端。无线模式下服务端和被控端之间走的是一条标准 TCP 连接。理解这一层后面遇到的超时、refused、drop 都能对症定位。提示5555 是 adbd 的默认监听端口可替换成其他未被占用的端口排查端口冲突时会用到。2.2 从 adb tcpip 到 adb connect 的握手细节标准流程分三步顺序不能颠倒# 1. 确认设备已通过 USB 被识别状态应为 device adb devices # 2. 让设备端 adbd 切换到 TCP/IP 模式并监听 5555 adb tcpip 5555 # 3. 断开 USB用手机当前 IP 连接 adb connect 192.168.1.100:5555第 1 步输出中的device状态是关键出现unauthorized或offline都不能往下走。第 2 步执行后会返回restarting in TCP mode port: 5555部分机型这时 USB 连接会短暂中断属正常现象。第 3 步成功时返回connected to 192.168.1.100:5555再跑一次adb devices就能看到一条带 IP 的记录。失败最常见的两个原因一是 IP 写错二是手机和 PC 不在同一网段。同一网段是硬条件IP 通常在 192.168.x.x 或 10.0.x.x 之间前缀必须一致。还有一个隐形杀手是路由器的 AP 隔离公司 Wi-Fi 和公共热点常默认开启开了之后同一 SSID 下的设备互不可见表现就是connection refused或者一直超时。家用路由器可以在无线设置里关掉这个选项。注意手机上显示的 IP 有时候是 IPv6 地址adb 无线调试走的是 IPv4认准ip -f inet过滤出来的那条。2.3 插件按钮背后等价于哪几条命令Android WIFI ADB 插件做的拆分并不神秘点击工具栏按钮时大致执行了这几步插件动作等价 adb 命令说明读取设备 IPadb shell ip -f inet addr show wlan0从 wlan0 取 IPv4切换无线模式adb tcpip 5555固定端口插件一般用默认值建立连接adb connect ip:5555成功后写入 adb 设备列表断开连接adb disconnect ip:5555掉线或切换网络时用知道这个等价关系最大的好处是排错时能分层判断插件按钮不响应先手动敲这三条命令命令能通说明是插件问题命令也不通就回去查 USB、网络和 adbd 状态。抓取设备 IP 也可以用adb shell ifconfig wlan0但 Android 10 之后部分 ROM 已经移除ifconfig所以更推荐ip addr show wlan0或ip -f inet addr show wlan0。3. Android Studio 插件与 adb 命令行双路径实操3.1 Android WIFI ADB 插件安装与工具栏还原在 Android Studio 里走 Settings → Plugins → Marketplace搜索 Android WIFI ADB安装后重启 IDE。重启完成后顶部工具栏应该会出现一个小手机带 Wi-Fi 波形的图标。如果没出现可以右键工具栏空白处选择 Customize Menus and Toolbars或者从 File → Settings → Appearance Behavior → Menus and Toolbars 里手动把它拖出来。老一代的 adb wifi 插件是另一条路需要手机端另外装一个配合 App通过那个 App 开启监听端口再回 AS 里手动输入 IP。多了一步配对稳定性也一般所以现在基本被 Android WIFI ADB 替代。相比之下新插件把查 IP、切模式、连设备三件事合并成一次点击能省下不少敲命令的时间。插件路径的短板也是实打实的——它同样需要先检测到 USB 在线设备才能拿到 IP 切 tcpip。所以“插线”这一步谁都绕不过去。有人以为装了插件就能完全没有数据线其实第一次连接始终需要 USB 参与。3.2 手动 adb tcpip adb connect 完整步骤不想装插件、或者用命令行工具、CI 环境里跑自动化手动路径更通用# 确认 adb 版本新版对无线支持和调试体验更好 adb version # 列出当前 USB 设备-l 会带上型号和 transport_id adb devices -l # 取出设备 wlan 的 IPv4 地址 adb shell ip -f inet addr show wlan0 # 切到 TCP/IP 模式指定监听端口 adb tcpip 5555 # 用上一步拿到的 IP 连接 adb connect 192.168.1.100:5555 # 拔掉 USB 后再次确认 adb devices逐条解释一下。adb version主要是确认 adb 工具版本太老的 adb 对 Android 11 的无线调试支持不完整。adb devices -l里的-l会打印设备型号、transport_id 等信息多设备场景用来区分目标。adb shell ip -f inet addr show wlan0只过滤 IPv4 地址比ifconfig在 Android 10 以后更可靠。adb tcpip 5555是核心一步括号里的数字是监听端口不写就默认 5555。adb connect成功后logcat、断点、adb install、adb shell全部能照常使用。想断开用adb disconnect 192.168.1.100:5555想彻底关掉无线监听切回 USB插回数据线执行adb usb即可。提示adb tcpip之后不要立即拔线等 12 秒让 adbd 完成重启否则 connect 的成功率会明显下降。3.3 参数取舍与场景对照把常用选项整理成一张表方便按场景挑参数 / 选项常用取值何时改 / 何时用adb tcpip port55555555 被占或公司策略限制时改adb connect ip:portIP:5555端口须与 tcpip 保持一致-s serial序列号或 IP多设备同时在线时指定目标adb -a监听所有网卡从其他主机连本机 adb serveradb -P port5037adb server 端口冲突时改-s和-P是最常用的两个。-s前面已经说过多设备必须带。-P主要在同时跑多套调试环境时出现比如一台机器上既开发又跑自动化测试。adb -a一般不需要除非有从局域网另一台机器连本机 adb server 的需求安全上也建议保持默认。注意端口改过之后adb connect的端口必须跟adb tcpip一致写错端口是connection refused的高频原因。4. 多设备、断线重连与 adb 无线调试常见报错排查4.1 adb devices 输出状态逐项解读adb devices的输出只有几列但每一列都能用来定位问题输出片段含义下一步device正常在线可直接调试unauthorized未授权等待手机端弹窗确认看手机屏幕点“允许”offline连接建立但 adbd 无响应重连或重启 adb server空列表adb server 未识别到设备查 USB、驱动、IPunauthorized常见于换了新电脑、重装系统或者手机恢复出厂设置之后。手机端“USB 调试授权”弹窗如果之前手快点过“拒绝”之后再插线也不会弹得进开发者选项里的“撤销 USB 调试授权”清空记录重新插一次。offline多见于无线连接不稳定路由器短时间丢包后 adb 认为设备还在列表里实际链路已经断了。空列表这一格看似没问题实际上是最难查的一类。USB 下空列表通常是驱动没装好Windows 上的 Google USB Driver 或厂商驱动无线下空列表则要先确认 adb server 是否还在运行。4.2 connection refused 与 timeout 的区分处理两者表现相近成因不一样。connection refused是 TCP 层明确拒绝说明目标 IP 可达但端口没有在监听——常见原因是adb tcpip没执行成功或设备重启后 TCP 模式丢失。timeout是连 IP 都不可达多半是不同网段、AP 隔离或者手机锁屏后 Wi-Fi 进入了省电休眠。排查顺序建议固定成一条链路# 1. 先确认 PC 能不能 ping 到手机 ping -c 2 192.168.1.100 # 2. 重启本地 adb server清掉缓存状态 adb kill-server adb start-server # 3. 断开再重连 adb disconnect 192.168.1.100:5555 adb connect 192.168.1.100:5555 # 4. 仍不通就走一次 USB重新 tcpip adb usb adb tcpip 5555 adb connect 192.168.1.100:5555第 1 步不通问题在网络层跟 adb 无关。第 2 步是很多疑难杂症的通用解法adb server 长时间运行后会缓存失效设备kill-server强制重扫。第 3 步针对离线设备做一次干净重连。第 4 步本质是回到有线再切一次把设备端 adbd 拉回已知状态。提示部分 Android 版本和厂商 ROM 在锁屏后休眠 Wi-Fi开发者选项里保持“不锁定屏幕”或“保持唤醒状态”开着能有效减少掉线。4.3 多设备并行与 -s 指定目标同时连了 USB 设备和无线设备时adb命令会报more than one device/emulator。解决办法是用-s指定# 用设备序列号指定序列号从 adb devices 输出第一列拿 adb -s ABC12345 logcat # 无线设备用 IP:端口 作为序列号 adb -s 192.168.1.100:5555 install app-debug.apk # 批量对多台无线设备执行 for ip in 192.168.1.100 192.168.1.101; do adb -s $ip:5555 shell getprop ro.build.version.release doneadb -s后面的值必须和adb devices第一列完全一致差一个字符都会变成device not found。写脚本时最常见的坑就是忘带-s然后命令随机打到了错误设备上这个坑在同时跑多个 App 的测试环境下尤其危险。另一种隔离手段是给每个设备起独立 adb server用ADB_SERVER_PORT环境变量加adb -P 5038 start-server多套环境互不干扰。配置麻烦、占用端口多一般只有自动化测试框架才会用。5. 无线调试脚本化与稳定重连的落点技巧插件和命令行都能连上以后真正烦人的是掉线后手动重连。把固定 IP 和重连逻辑写进一个小脚本是让无线调试真正可用的收尾动作。手机端把路由器里的 DHCP 绑定打开把手机的 MAC 固定到一个网段内的地址比如 192.168.1.100避免每次换 IP 都要重新查。脚本思路很简单先 ping 一次不通就说明网络掉了通了但 adb 列表里没有就走 connect。#!/usr/bin/env bash # 用法: ./adb-wifi-reconnect.sh 192.168.1.100 5555 IP${1:-192.168.1.100} PORT${2:-5555} # ping 一次判断网络可达性-c 1 发一个包-W 1 超时 1 秒 if ! ping -c 1 -W 1 $IP /dev/null; then echo network unreachable: $IP exit 1 fi # 如果设备已在列表先断开再重连避免脏状态 adb disconnect $IP:$PORT /dev/null 21 adb connect $IP:$PORT # 校验连接状态正常返回 device adb -s $IP:$PORT get-state脚本里ping -c 1 -W 1表示发 1 个包、超时 1 秒够快又不阻塞。adb disconnect先执行是有意为之adb 对同一 IP 重复 connect 时有时会返回成功但实际没连上先断后连更干净。最后get-state正常返回device就说明通了。真机场景里手机重启、Wi-Fi 重连、路由器重启都会让 TCP 模式丢失此时只能插一次 USB 重新adb tcpip。所以更实用的做法是把脚本挂到 shell 别名里掉线时一条命令跑完比手工敲五条命令节省时间。批量设备调试可以再套一层 for 循环把 IP 列表读进变量逐个连。再往前一步可以把adb tcpip 5555的触发点交给 Android Studio 的 Before Launch 任务每次 Run 之前自动跑一次连接脚本。这样即便中途掉线下一次 Run 也会自动恢复把无线调试从“偶尔用用”变成日常主路径。本文还有配套的精品资源点击获取