ADB（Android Debug Bridge）是 Android 开发和测试不可或缺的调试工具，它建立了电脑与 Android 设备之间的通信桥梁，通过命令行指令可实现对设备的全方位控制。掌握 ADB 指令能大幅提升开发效率，解决各类调试难题。本文系统整理了 ADB 的常用指令，按功能分类详解，包含使用场景与实战示例，助你快速成为 ADB 高手。

一、ADB 基础与环境配置

什么是 ADB？

ADB 是 Android SDK 中的一个命令行工具，全称为 Android Debug Bridge，本质是一个客户端 - 服务器程序，包含三个核心组件：

• 客户端：运行在开发机上，负责接收用户输入的指令（如命令行输入adb命令）

• 守护进程（daemon）：以adbd进程形式运行在 Android 设备后台，负责执行客户端发送的指令

• 服务器：运行在开发机后台的adb进程，负责管理客户端与设备守护进程的通信，协调多个客户端与设备的连接

ADB 最初由 Google 在 Android 1.0 时代推出，设计初衷是解决开发过程中 "设备 - 开发机" 交互的痛点。它基于 TCP/IP 协议实现通信，默认通过 USB 接口传输数据，也支持无线连接模式。经过十余年演进，ADB 已从简单的调试工具发展为集设备管理、应用调试、系统控制于一体的全能工具，成为 Android 开发生态中不可或缺的基础设施。

其核心价值体现在：

• 打破应用沙箱限制，允许开发机直接操作设备底层资源

• 提供统一的命令接口，兼容从手机到智能手表的全系列 Android 设备

• 支持跨平台操作（Windows/macOS/Linux），保障开发环境一致性

ADB 的工作原理

ADB 的通信流程遵循典型的 C/S 架构：

1.当用户在终端输入adb命令时，客户端会向本地 ADB 服务器发送请求（默认端口 5037）

2.服务器检查是否已与目标设备建立连接，若未连接则尝试通过 USB 或网络发现设备

3.服务器将指令转发至设备上的adbd守护进程

4.守护进程执行指令并将结果通过服务器返回给客户端

5.客户端将结果显示在终端界面

这种分层架构的优势在于：

• 支持多客户端同时连接（如同时打开多个命令行窗口操作设备）

• 服务器自动管理设备连接状态，无需用户手动维护通信链路

• 指令执行与结果返回的异步处理，提升复杂操作的效率

环境配置步骤

1.安装 Android SDK Platform Tools：

• 官网下载对应系统的 Platform Tools（包含 ADB 工具）
• 解压后将路径添加到系统环境变量（Windows 的 PATH 或 macOS/Linux 的.bashrc/.zshrc）
• 验证安装：打开终端输入adb version，显示版本信息即表示安装成功

2.设备调试模式配置：

• 开启设备 "开发者选项"：连续点击系统版本号 7 次（不同品牌路径可能不同）
• 启用 "USB 调试" 选项（Android 11 + 需额外开启 "无线调试" 权限）
• 首次连接时，设备会弹出 "USB 调试授权" 窗口，勾选 "始终允许此计算机" 以避免重复授权

3.连接设备：

• 有线连接：用 USB 线连接设备与电脑，通过adb devices确认连接状态
• 无线连接：需先通过 USB 配置（见后文详解），适合需要摆脱线缆束缚的场景

4.确认连接状态：

adb devices

正常情况下会显示设备序列号及状态：

• device：连接正常，可执行指令
• offline：设备已连接但未响应（通常需重启 ADB 或设备）
• unauthorized：未授权调试权限（需在设备上确认授权）

ADB 的安全机制

为保护用户隐私与设备安全，ADB 采用多层次安全措施：

1.调试授权机制：首次连接新设备时必须通过设备端确认，防止未授权计算机访问设备

2.权限分级：普通 ADB 指令受限于设备用户权限，敏感操作（如修改系统文件）需 root 权限

3.无线调试加密：Android 11 + 的无线调试采用配对码验证，避免局域网内的恶意连接

4.沙箱隔离：非 root 状态下，ADB 无法直接访问其他应用的私有目录，保障数据隔离

这些机制平衡了开发便利性与设备安全性，尤其在 Android 6.0 引入运行时权限后，ADB 的权限管控更加严格，部分系统级操作需通过pm grant显式授权。

二、设备管理指令

查看设备信息

实战示例：

# 查看所有设备详细信息
adb devices -l# 查看设备型号和Android版本
adb shell getprop ro.product.model
adb shell getprop ro.build.version.release

设备连接控制

无线连接步骤：

1.先用 USB 连接设备，设置端口：adb tcpip 5555

2.断开 USB，通过 IP 连接：adb connect 设备IP:5555（设备 IP 在 WLAN 设置中查看）

3.验证连接：adb devices

注意：设备与电脑需在同一局域网，部分设备需开启 "无线调试" 选项（Android 11+）

三、应用操作指令

应用安装与卸载

常用参数：

• -r：保留数据和缓存文件，用于应用更新

• -t：允许安装测试包

• -d：允许降级安装（低版本覆盖高版本）

实战示例：

# 覆盖安装并保留数据
adb install -r app-release.apk# 卸载应用但保留用户数据
adb uninstall -k com.example.myapp

应用运行控制

启动指定 Activity 示例：

# 启动应用主Activity
adb shell am start -n com.example.myapp/.MainActivity# 启动带参数的Activity
adb shell am start -n com.example.myapp/.DetailActivity -e "id" "123" -e "name" "test"

查看应用安装路径：

adb shell pm path com.example.myapp

四、文件传输指令

电脑与设备间传输文件

路径说明：

• 设备常用路径：/sdcard/（外部存储根目录）、/data/data/<包名>/（应用私有目录）

• 注意权限：访问/data/data/下的文件可能需要 root 权限

实战示例：

# 推送本地图片到设备相册
adb push ./photo.jpg /sdcard/DCIM/Camera/# 拉取应用缓存文件到本地
adb pull /data/data/com.example.myapp/cache/ ./app_cache

设备内部文件操作

结合adb shell可执行设备内部的文件操作：

# 进入设备shell环境
adb shell# 查看目录内容
ls /sdcard/# 创建目录
mkdir /sdcard/testdir# 移动文件
mv /sdcard/file1.txt /sdcard/testdir/# 复制文件
cp /sdcard/file1.txt /sdcard/testdir/file2.txt# 删除文件
rm /sdcard/test.txt# 查看文件内容
cat /sdcard/log.txt# 退出shell
exit

注意：部分目录操作需要 root 权限，可通过adb root获取（仅适用于已 root 设备或模拟器）

五、调试与诊断指令

日志查看

日志级别（从低到高）：

• V（Verbose）：详细信息（默认）

• D（Debug）：调试信息

• I（Info）：普通信息

• W（Warn）：警告信息

• E（Error）：错误信息

• F（Fatal）：致命错误

• S（Silent）：无输出

实战示例：

# 只显示应用的错误日志
adb logcat com.example.myapp:E *:S# 显示所有错误级别以上的日志并保存
adb logcat *:E > error_log.txt

进程与性能监控

实用技巧：

• adb shell top -d 3：每 3 秒刷新一次进程信息

• adb shell dumpsys meminfo：不加包名可查看系统整体内存使用

• adb shell dumpsys gfxinfo <包名> reset：重置渲染性能统计

屏幕与截图

屏幕录制参数：

• --time-limit 30：限制录制时长（默认 180 秒）

• --bit-rate 4M：设置比特率（默认 4Mbps）

• --size 1280x720：设置录制分辨率

示例：

# 录制60秒，比特率8Mbps的视频
adb shell screenrecord --time-limit 60 --bit-rate 8M /sdcard/gameplay.mp4# 直接截图到电脑
adb exec-out screencap -p > current_screen.png

六、系统与高级指令

系统信息与控制

模拟输入示例：

# 点击屏幕坐标(500, 1000)
adb shell input tap 500 1000# 滑动屏幕（从(100,500)到(900,500)）
adb shell input swipe 100 500 900 500 500（持续500ms）# 输入文本
adb shell input text "HelloADB"# 按电源键
adb shell input keyevent KEYCODE_POWER# 按返回键
adb shell input keyevent KEYCODE_BACK

权限与 root 相关

注意：

• 大部分设备需要解锁 Bootloader 才能获取 root 权限

• pm grant只能授予应用在 Manifest 中声明的权限

• 特殊权限（如WRITE_SECURE_SETTINGS）需通过 ADB 或 root 授予

七、实用技巧与常见问题

提高效率的技巧

1.别名设置：为常用指令设置别名（如在.bashrc 中）：

alias adbip='adb connect 192.168.1.100:5555'
alias adbl='adb logcat -s MyApp'
alias adbs='adb shell'

2.多设备操作：当连接多个设备时，用-s指定设备：

adb -s 192.168.1.100:5555 install app.apk
adb -s emulator-5554 shell

3.命令组合：结合管道符实现复杂功能：

# 查找应用进程并杀死
adb shell ps | grep com.example.myapp | awk '{print $2}' | xargs adb shell kill

4.ADB 路径自动补全：配置 bash 自动补全脚本，支持指令和路径补全

常见问题解决

1.设备连接失败（offline 状态）：

• 解决方案：重启 ADB 服务器（adb kill-server && adb start-server）
• 重新插拔 USB 线或重启设备

2.无权限访问设备（no permissions）：

• Windows：在设备上授权 USB 调试
• Linux/macOS：执行sudo chmod 777 /dev/bus/usb/<设备路径>（路径可通过lsusb查看）

3.应用安装失败（INSTALL_FAILED_XXX）：

• INSTALL_FAILED_INSUFFICIENT_STORAGE：设备存储空间不足
• INSTALL_FAILED_VERIFICATION_FAILURE：关闭 "验证应用" 选项
• INSTALL_FAILED_UPDATE_INCOMPATIBLE：先卸载旧版本再安装

4.无线连接超时：

• 确保设备与电脑在同一网络
• 检查防火墙设置，允许 5555 端口通信
• 尝试重启设备的网络或 ADB 服务

八、总结

ADB 是 Android 开发的瑞士军刀，掌握这些指令能显著提升日常开发和调试效率。本文涵盖了设备管理、应用操作、文件传输、调试诊断等核心场景的常用指令，建议初学者从基础指令开始练习，逐步掌握高级用法。

实际使用中，不必死记硬背所有指令，可将本文作为速查表随时查阅。随着使用频率增加，自然会熟练掌握常用命令。ADB 的强大之处在于其灵活性，通过组合不同指令，能解决几乎所有设备交互问题，是每个 Android 开发者必备的技能。