一、准备工作

（一）下载ADB工具

Android Debug Bridge（ADB） 是 Android SDK 提供的客户端-服务器工具，作为 Android 设备与电脑之间的调试桥梁。根据系统选择对应压缩包进行下载并解压：

• Windows
• Mac
• Linux

（二）配置ADB的环境变量

1. 将下载的压缩包解压至 D:\adb
2. 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
3. 编辑 Path 变量 → 新增 D:\adb
   

（三）检查是否成功安装

打开cmd窗口，输入adb version查看adb版本

输入adb help查看帮助信息

（四）adb核心命令说明

命令格式	作用描述
adb devices	查看已连接的设备列表
adb tcpip <port>	设置无线调试端口（默认5555）
adb connect <ip>:<port>	通过IP和端口无线连接设备
adb -s <serial> ...	指定序列号对应的目标设备（多设备场景）

二、无线调试流程

（一）环境要求

手机与电脑需处于同一局域网（连接同一WiFi或电脑通过网线接入手机所在路由器）。

（二）连接手机与电脑

• 1.用USB数据线连接手机与电脑，手机端确认“允许USB调试”。
• 2.打开命令行（Windows用CMD/PowerShell，Mac用Terminal），输入adb devices命令查看设备序列号列表。（若未检测到设备，需安装手机驱动或检查USB线是否正常）
  

（三）配置TCP/IP端口

以设备1为例，输入adb -s b61b9ac20404 tcpip 5555命令设置端口（以5555为例）

• ps1：若提示权限问题，可尝试以管理员身份运行命令行。
• ps2：若只有一个设备可以直接用adb tcpip 5555命令

（四）激活无线连接

1. 获取手机IP地址

   • 拔掉USB线，进入手机「设置」→「WLAN」→ 点击当前连接的WiFi名称，查看「IP地址」（如192.168.1.106）。

2. 建立无线连接

   • 在命令行输入： adb connect 192.168.1.106:5555
     

   • 若连接失败，可尝试：

     • 检查IP地址是否正确（重启路由器或手机WiFi后可能变更）。
     • 确认端口未被占用（可更换为其他端口如8888）。

3. 验证连接状态

   • 输入adb devices，若显示192.168.1.106:5555 device，表示无线连接成功。

（五）使用scrcpy工具投屏显示

通过以下链接下载并解压scrcpy工具：
官方下载
直接下载
点击scrcpy.exe运行即可成功投屏

三、常见问题与解决方案

问题现象	可能原因	解决方法
adb connect失败	IP地址错误或端口被占用	重新获取IP，更换端口（如5556）
设备断开后无法重连	手机IP变更（如WiFi重连）	重新查看IP地址，使用新IP连接
adb devices无设备显示	ADB服务未启动或驱动异常	输入adb kill-server+adb start-server重启ADB
多设备连接时命令混淆	未指定设备序列号	在命令中添加-s <serial>参数

四、进阶技巧

1. 自动化脚本

   • 在Mac/Linux系统中，可创建Shell脚本批量配置多设备：

     # wireless_debug.sh
     #!/bin/bash
     adb -s $1 tcpip $2
     adb connect $3:$2
     

   • 执行：./wireless_debug.sh 设备序列号 端口号 IP地址。

2. 固定IP设置

   • 在路由器管理页面为手机分配静态IP，避免因DHCP租期到期导致IP变更。

3. 防火墙设置

   • 若公司网络限制，需联系管理员开放TCP端口（如5555）的入站/出站权限。

五、优势与应用场景

• 优势：
  • 摆脱USB线束缚，支持设备在局域网内移动调试。
  • 同时连接多台设备，提升多机型兼容性测试效率。
• 适用场景：
  • 大屏设备（如平板、电视盒子）调试。
  • 需模拟弱网络环境的性能测试。
  • 团队协作开发时的多设备并行调试。

通过无线调试，开发者可更灵活地进行真机测试，尤其适合需要频繁移动设备或同时调试多台终端的场景。