ADB 连接使用说明（Windows & macOS）
1. 什么是 ADB？
ADB（Android Debug Bridge）是 Android 开发/调试的通用工具，它允许你通过命令行与 Android 设备（手机、平板、电视、车机等）进行通信，执行安装应用、查看日志、模拟点击等各种操作。
2. 环境配置（安装 ADB）
Windows 系统
- 下载 Platform-Tools
- 官方下载：Android Developers 官网
- 国内镜像（可选）：搜索 “Android 平台工具” 下载最新 ZIP 包。
- 解压与放置
- 将下载的
platform-tools.zip解压到一个无中文空格的路径，例如C:\adb。
- 将下载的
- 配置系统环境变量（可选但推荐）
- 右键点击“此电脑” → “属性” → “高级系统设置” → “环境变量”。
- 在“系统变量”中找到
Path变量，点击“编辑” → “新建”，填入你的 ADB 目录路径（如C:\adb）。 - 点击确定保存。
- 验证安装
- 按
Win + R，输入cmd打开命令提示符，输入：adb version - 若显示版本号，则配置成功。
- 按
macOS 系统
- 通过 Homebrew 安装（推荐）
- 打开终端（Terminal），执行：
brewinstallandroid-platform-tools
- 打开终端（Terminal），执行：
- 手动下载安装（备选）
- 同 Windows，下载官方
platform-tools.zip并解压。 - 将解压后的目录移动到
/usr/local/下，或直接使用绝对路径。
- 同 Windows，下载官方
- 配置环境变量（手动安装时需要）
- 编辑 Shell 配置文件（根据你的 Shell 类型选择
~/.zshrc或~/.bash_profile）：exportPATH=$PATH:/你的解压路径/platform-tools - 执行
source ~/.zshrc使其生效。
- 编辑 Shell 配置文件（根据你的 Shell 类型选择
- 验证安装
- 终端输入：
adb version
- 终端输入：
3. 设备连接准备（通用）
3.1 手机端开启开发者模式
- 进入“设置” → “关于手机”。
- 连续点击“版本号”7 次，直到提示“已进入开发者模式”。
- 返回“设置” → “系统” → “开发者选项”。
- 开启“USB 调试”和“USB 安装”（如有）。
3.2 充电模式设置
- 连接电脑时，将 USB 用途设置为“传输文件（MTP）”或“传输照片（PTP）”，不要仅设为“仅充电”。
4. USB 有线连接（Windows & macOS）
操作步骤
- 使用数据线将 Android 设备连接至电脑。
- 打开终端（或 CMD），输入：
adb devices - 手机上会弹出“允许 USB 调试吗？”的授权弹窗，勾选“始终允许”，点击“确定”。
- 再次输入
adb devices，若看到类似以下输出，表示连接成功：List of devices attached ABC123DEF456 device
常见问题
| 现象 | 解决方法 |
|---|---|
设备显示unauthorized | 手机上重新确认授权弹窗，或撤销授权后重试（开发者选项内可重置）。 |
设备显示offline | 重新插拔数据线，重启 adb 服务：adb kill-server+adb start-server。 |
| 找不到设备（Windows） | 安装手机品牌对应的官方 USB 驱动程序（如小米、华为、三星官网下载）。 |
| 找不到设备（macOS） | 尝试更换数据线（建议使用原装线），或更换 USB 端口。 |
5. 无线连接（Wi-Fi ADB）
前置条件
- 电脑和 Android 设备连接同一 Wi-Fi 网络。
- 设备已通过 USB 连接并授权过（首次需有线配对）。
方法一：Android 11+ 无线调试（原生支持）
- 确保设备已连接 Wi-Fi。
- 进入“开发者选项” → 开启“无线调试”。
- 点击“无线调试” → “使用配对码配对”。
- 记下显示的IP 地址、端口和配对码。
- 电脑终端执行配对：
adb pair192.168.1.100:XXXXX# 输入配对码 - 配对成功后，执行连接：
adb connect192.168.1.100:XXXXX# 注意：此处端口可能与配对时不同 - 执行
adb devices确认状态为device。
方法二：通过 USB 切换至无线（通用）
- 先用 USB 连接设备，确保
adb devices能看到设备。 - 获取设备 IP 地址（在“关于手机” → “状态信息”中查看，或执行
adb shell ip addr show）。 - 执行切换命令：
# 设置无线端口adb tcpip5555# 断开 USB 线，连接设备adb connect192.168.1.100:5555 - 成功后即可拔掉数据线进行无线调试。
断开无线连接
adb disconnect192.168.1.100:55556. 常用 ADB 命令速查
| 功能 | 命令 |
|---|---|
| 查看已连接设备 | adb devices |
| 安装 APK | adb install -r app.apk（-r 覆盖安装） |
| 卸载应用 | adb uninstall 包名 |
| 查看设备日志 | adb logcat |
| 截屏 | adb shell screencap /sdcard/screen.pngadb pull /sdcard/screen.png |
| 录屏 | adb shell screenrecord /sdcard/demo.mp4 |
| 获取设备型号 | adb shell getprop ro.product.model |
| 重启 ADB 服务 | adb kill-server+adb start-server |
| 进入 Shell 交互 | adb shell |
7. 多设备管理
当连接多个设备时，命令需指定设备序列号：
# 查看所有设备及序列号adb devices# 指定设备执行命令adb-sABC123DEF456installapp.apk adb-sABC123DEF456 logcat8. 排错 Check List
遇到连接问题时，请按顺序检查：
- USB 数据线是否为原装/支持数据传输线（非仅充电线）。
- 开发者选项中USB 调试是否已开启。
- 手机是否已授权电脑的 RSA 指纹。
- 电脑端的 ADB 驱动是否安装正确（Windows 重点检查设备管理器）。
- 是否关闭了第三方手机助手（如 360、豌豆荚），它们可能占用 ADB 端口。
- 重启 ADB 服务：
adb kill-server再adb start-server。
提示：无线连接受 Wi-Fi 信号影响较大，稳定性不如 USB，频繁进行大量数据传输（如长时间 logcat）建议使用有线连接。
原文地址：
https://mobile-ai-use.com/blog/Trq9UjK09WkNtH4p
