1. 项目概述为什么你需要一份“活”的ADB命令手册如果你在移动开发、测试或者设备运维的圈子里待过哪怕只是偶尔折腾一下自己的安卓设备ADBAndroid Debug Bridge这个名字你一定不陌生。它就像一把万能钥匙连接着你的电脑和安卓设备能让你在命令行里完成从安装应用到深度调试、从文件管理到性能抓取等一系列操作。网上流传的“ADB命令大全”很多但大多数都是简单的罗列告诉你“adb install是安装应用”却很少说清楚为什么有时候安装会失败或者在不同系统版本下有什么坑。今天这份“大全”我想换个写法。它不仅仅是一个命令列表更像是我过去这些年在真机调试、自动化测试和解决各种稀奇古怪的设备问题时积累下来的一份“实战笔记”。我会把命令分门别类但更重要的是我会告诉你每个命令在什么场景下最有用执行时可能会遇到什么“坑”以及如何结合其他命令形成解决问题的“组合拳”。毕竟记住命令是简单的理解命令背后的逻辑和适用边界才是提升效率的关键。无论你是刚入门的新手想搞清楚ADB到底是什么还是有一定经验的开发者希望找到一些高效调试的技巧甚至是测试工程师需要构建稳定的自动化脚本这篇文章都能给你提供直接的参考。我们的目标是让你手里的ADB从一个冷冰冰的工具变成一个真正懂业务、能解决问题的得力助手。2. ADB核心架构与连接原理理解“桥”是如何搭建的在开始罗列命令之前我们有必要花几分钟理解一下ADB到底是怎么工作的。很多连接问题、命令执行失败的根源都源于对底层机制的不了解。ADB不是一个单一的程序而是一个C/S客户端-服务器架构的调试工具套件它主要包含三个组件ADB Client客户端这就是你在电脑命令行里敲入的adb命令。它负责接收你的指令。ADB Server服务器这是一个在电脑后台运行的守护进程。当你第一次执行任何adb命令时它会自动启动。它的核心作用是管理客户端与所有已连接设备或模拟器之间的通信。一个非常重要的特点是同一台电脑上同一时间只能运行一个ADB Server实例。这解释了为什么有时关闭再重启ADB服务能解决很多疑难杂症。ADB Daemon守护进程这是一个运行在安卓设备或模拟器后台的进程通常叫adbd。它负责接收来自ADB Server的指令并在设备上执行。那么连接是如何建立的呢当你通过USB线连接设备并开启调试模式或者在同一个网络下配置了无线调试ADB Server会尝试与设备上的adbd进程建立连接。连接成功后你的Client指令通过Server最终由adbd在设备上执行并将结果返回。注意很多新手会混淆“设备连接”和“ADB识别”。电脑弹出设备连接提示只代表USB物理连接和MTP文件传输模式就绪。ADB要能识别设备必须同时满足1. 设备已开启“开发者选项”中的“USB调试”开关2. 电脑上已安装对应设备的ADB驱动Windows系统常见问题3. 对于首次连接的设备需要在设备屏幕上点击“允许USB调试”的授权弹窗。2.1 连接模式详解USB与Wi-Fi的取舍USB连接是最稳定、最常用的方式。优势是延迟极低传输文件速度快且连接稳定。但缺点是被线缆束缚。在Windows上驱动问题是头号杀手。你可以通过adb devices命令查看如果设备显示为unauthorized说明没点授权如果显示一串乱码如HT74C1A12345 unauthorized通常是驱动问题需要手动安装或使用第三方工具如Google的USB Driver解决。Wi-Fi连接则提供了灵活性适合设备需要移动或USB口紧张的场景。但设置稍显繁琐且对网络稳定性要求高。传统方法是先用USB线执行adb tcpip 5555将设备的adbd切换到TCP模式监听5555端口然后拔掉线执行adb connect 设备IP:5555。安卓11及以上版本提供了更便捷的“无线调试”选项可以直接在开发者选项里配对无需USB线初始连接。实操心得对于固定工位上的测试机我强烈建议使用USB连接稳定压倒一切。对于需要频繁拿取或演示的设备可以配置好Wi-Fi连接备用。但切记Wi-Fi连接在设备重启后通常会失效需要重新connect。在编写自动化脚本时务必加入连接状态检查的逻辑避免因连接断开导致脚本失败。3. 设备管理与基础操作命令从入门到熟练这是ADB命令的基石也是使用频率最高的一组命令。掌握它们你就已经能解决80%的日常问题了。3.1 设备连接与状态查询一切操作的前提是ADB能识别到你的设备。adb devices这是你的“雷达屏幕”。列出当前所有连接到ADB Server的设备包括模拟器。输出示例List of devices attached 74C1A1234567 device emulator-5554 device第一列是设备的序列号SN对于真机通常是硬件序列号或Wi-Fi调试的IP:端口对于模拟器是emulator-端口格式。第二列是连接状态device代表已授权连接offline代表设备未响应可能处于休眠或异常状态unauthorized代表等待用户授权。adb connect IP:端口/adb disconnect IP:端口用于Wi-Fi连接的连接与断开。adb kill-server/adb start-server**ADB服务的“重启大法”。当遇到设备列表异常、连接不稳定、或者ADB命令无响应时首先尝试adb kill-server结束服务它会自动重启。这是解决很多玄学问题的第一选择。adb -s 设备序列号 命令当连接了多台设备时用-s参数指定对哪一台设备执行后续命令。例如adb -s 74C1A1234567 shell。如果不指定ADB会随机挑选一台device状态的设备执行这在自动化中非常危险。3.2 应用包管理安装、卸载与信息获取应用管理是开发和测试的核心。adb install apk路径安装应用。最常用的参数是-r替换安装保留数据和-t允许安装测试包。踩坑记录安装失败时一定要看错误信息。INSTALL_FAILED_VERSION_DOWNGRADE表示安装的版本比现存版本旧INSTALL_FAILED_UPDATE_INCOMPATIBLE通常是因为签名不一致。对于系统应用或需要特殊权限的应用可能需要-g参数来授予所有清单文件中声明的权限。adb uninstall 包名卸载应用。加-k参数可以保留数据和缓存目录仅卸载应用本身常用于测试数据清理。adb shell pm list packages列出设备上所有安装的包名。常用过滤参数-3只列出第三方应用。-s只列出系统应用。-f列出包名及对应的APK路径。-i列出包名及其安装来源。结合grep进行筛选如adb shell pm list packages | grep “tencent”。adb shell dumpsys package 包名获取某个应用的详细信息宝库。这里包含了版本号、权限、Activity、Service、Provider等所有清单文件中的信息以及应用的UID、数据目录等。输出内容很多通常配合grep查找特定信息例如adb shell dumpsys package com.example.app | grep versionName。3.3 文件传输双向同步与备份在设备和电脑间搬运文件。adb push 本地路径 设备路径将电脑文件推送到设备。例如adb push ./update.zip /sdcard/。adb pull 设备路径 本地路径将设备文件拉取到电脑。例如adb pull /sdcard/log.txt ./。重要技巧如果拉取整个目录Windows命令行可能需要使用/而不是\且目录路径最好用双引号括起来避免空格等问题。adb sync这是一个更智能的文件同步命令它会比较本地和设备的文件差异只传输修改过的部分。但在普通文件传输中不如push/pull直观常用于系统编译后的镜像同步。3.4 日志抓取定位问题的眼睛日志是调试的生命线。adb logcat最核心的日志命令。默认输出所有标签和优先级的日志信息洪流。必须掌握过滤技巧按标签和优先级过滤adb logcat 标签:优先级 *:S。例如adb logcat ActivityManager:I MyApp:D *:S只显示ActivityManager的Info及以上级别和MyApp的Debug及以上级别日志其他全部静默S代表Silent。这是最精准的过滤方式。按关键字过滤adb logcat | grep -i “crash”。按进程ID过滤adb logcat --pidPID。清空日志缓冲区adb logcat -c然后开始抓取可以获得一个干净的日志起点。将日志输出到文件adb logcat -v time log.txt-v time参数会给每行日志加上时间戳对于分析问题至关重要。adb bugreport这是一个“重型武器”。它会生成一个包含系统状态、所有日志logcat、kernel、event等、进程信息、内存信息等几乎全部调试信息的ZIP文件。文件通常很大但当你遇到无法复现的复杂崩溃或系统性问题时这是提供给开发人员最完整的资料。生成较慢请耐心等待。4. 高级Shell命令与系统交互深入设备腹地adb shell让你进入设备的Linux命令行环境。在这里你可以使用大部分标准的Linux命令以及安卓特有的工具。4.1 进程与性能监控了解设备正在运行什么以及资源消耗情况。adb shell ps/adb shell ps -A查看进程列表。-A参数查看所有进程包括其他用户的。结合grep查找特定应用进程adb shell ps | grep 包名可以快速拿到应用的PID进程ID和UID用户ID。adb shell top实时动态显示进程资源占用情况CPU、内存。类似Linux的top命令。常用参数-d 1表示1秒刷新一次-m 10显示前10个进程。在测试应用性能尤其是排查卡顿、发热问题时非常有用。adb shell dumpsys meminfo 包名或PID获取某个应用详细的内存使用报告。包括Java堆、Native堆、PSS、USS等各个维度的内存数据。这是分析内存泄漏和优化内存性能的标准工具。adb shell dumpsys cpuinfo查看CPU负载信息。adb shell dumpsys battery查看电池状态信息可以手动设置电量水平或充电状态用于测试应用在不同电量下的行为adb shell dumpsys battery set level 50设置电量为50%adb shell dumpsys battery set status 2设置为充电状态。4.2 输入模拟与界面控制实现自动化操作的基础。adb shell input模拟各种输入事件。adb shell input text “hello”在当前焦点输入框输入文本不支持中文。adb shell input keyevent 键值模拟按键例如KEYCODE_HOME3、KEYCODE_BACK4。adb shell input keyevent 4就是按返回键。adb shell input tap x y模拟点击屏幕坐标。adb shell input swipe x1 y1 x2 y2 [duration]模拟滑动。可选的duration参数是滑动耗时毫秒可以用来控制滑动速度。adb shell uiautomator dump获取当前屏幕的UI布局XML文件保存到/sdcard/window_dump.xml然后可以用adb pull拉取到电脑查看。结合adb shell uiautomator dump --compressed可以生成压缩版。虽然不如Appium等框架强大但在快速编写简单自动化脚本或查看控件信息时很方便。adb shell screencap -p /sdcard/screen.png截取屏幕截图并保存。然后通过adb pull拉取。-p参数指定保存为PNG格式。adb shell screenrecord 文件路径录制屏幕安卓4.4以上。默认录制3分钟可用--time-limit参数设置时长--size设置分辨率。例如adb shell screenrecord --time-limit 30 /sdcard/demo.mp4。注意某些设备出于安全限制可能无法录制DRM保护内容或安全键盘输入。4.3 系统设置与属性控制动态调整设备行为。adb shell settings访问安卓的Settings Provider可以读写全局、系统、安全的设置项。adb shell settings put global airplane_mode_on 1打开飞行模式需要再执行adb shell am broadcast -a android.intent.action.AIRPLANE_MODE广播生效。adb shell settings get system screen_brightness获取当前屏幕亮度值。这个命令非常强大可以修改很多开发者选项里的开关需知道对应的key常用于自动化测试的初始环境配置。adb shell wm管理窗口管理器。adb shell wm size显示当前屏幕物理分辨率。adb shell wm size 1080x1920修改显示分辨率临时重启恢复。用于测试应用在不同分辨率下的适配。adb shell wm density显示屏幕密度。adb shell wm density 320修改屏幕密度临时。adb shell pm除了列出包还能管理应用权限。adb shell pm grant 包名 权限授予权限。例如adb shell pm grant com.example.app android.permission.ACCESS_FINE_LOCATION。adb shell pm revoke 包名 权限撤销权限。这在自动化测试中用于绕过运行时权限弹窗非常有效。5. 调试与开发专属命令提升效率的利器这部分命令更偏向于开发和深度调试场景。5.1 应用启动与组件调试adb shell amActivity Manager命令用于启动组件、发送广播、启动服务等。启动Activityadb shell am start -n 包名/Activity全类名。例如adb shell am start -n com.example.app/.MainActivity。还可以附加-d data_uri、-t mime_type等参数传递Intent数据。启动Serviceadb shell am startservice -n 包名/Service全类名。发送广播adb shell am broadcast -a Action。例如发送一个自定义广播adb shell am broadcast -a com.example.MY_ACTION。强制停止应用adb shell am force-stop 包名。这比adb shell kill更干净会触发应用的生命周期回调。adb shell monkey著名的压力测试/随机事件工具。adb shell monkey -p 包名 -v 500向指定应用发送500个随机事件流。常用于进行应用的稳定性测试看是否会崩溃。可以设置种子-s复现事件序列或通过--pct-touch等参数调整各类事件的比例。5.2 网络与端口转发adb forward将本地端口转发到设备的指定端口。这是调试的“神技”之一。adb forward tcp:8080 tcp:8080将本地8080端口的请求转发到设备的8080端口。典型场景1调试WebView。应用内嵌的H5页面可以通过chrome://inspect进行调试ADB转发是背后的桥梁。典型场景2调试数据库。设备上的SQLite数据库文件可以通过adb forward和桌面SQLite客户端连接进行查看和操作。adb reverse反向端口转发安卓5.0以上。将设备端口的请求转发到本地端口。adb reverse tcp:8080 tcp:8080将设备上对8080端口的请求转发到本机的8080端口。典型场景在电脑上运行一个开发服务器如React Native的Metro Bundler默认端口8081在设备上运行的App需要访问这个服务器获取JS Bundle。配置adb reverse tcp:8081 tcp:8081后设备App直接访问localhost:8081就能连到电脑上的服务器无需配置IP地址极大方便了开发。5.3 备份与恢复已弃用但需了解adb backup/adb restore这两个命令曾经用于完整备份和恢复应用数据。但在较新版本的安卓中已被弃用并且存在诸多限制如需要设备屏幕解锁确认、不备份到外部存储等。对于应用数据备份现在更推荐使用各应用自带的云同步功能或者通过adb pull直接备份/data/data/包名目录需要root权限。了解它们是为了在必要时处理旧设备或特定需求。6. 实战问题排查与高效使用技巧命令是散的解决问题的能力是综合的。这里分享一些我遇到过的典型问题场景和解决思路以及如何将命令组合起来提升效率。6.1 常见连接与识别问题速查表问题现象可能原因排查步骤与解决方案adb devices列表为空1. USB调试未开启2. 驱动未安装Win3. 连接模式错误如仅充电4. ADB Server异常1. 进入开发者选项确认“USB调试”已开启。2. 检查设备管理器是否有黄色叹号安装对应驱动或通用ADB驱动。3. 在USB连接提示中选择“传输文件”或“PTP”模式。4. 执行adb kill-server然后重试。设备状态为unauthorized设备首次连接未授权电脑RSA密钥查看设备屏幕应出现“允许USB调试吗”的弹窗勾选“始终允许”后点击确定。设备状态为offline设备ADB守护进程adbd无响应1. 重启设备上的ADB调试开关。2. 重启设备。3. 更换USB线或USB口。adb shell提示error: no devices/emulators found无可用设备或设备未连接1. 确认设备已通过USB或Wi-Fi正确连接且状态为device。2. 多设备时使用adb -s 序列号 shell指定设备。Wi-Fi连接成功但命令无响应网络不稳定或设备进入深度休眠1. 保持设备屏幕常亮。2. 检查电脑和设备是否在同一局域网防火墙是否阻止了5555端口。3. 尝试adb disconnect后重新connect。6.2 组合命令与自动化脚本片段单个命令能力有限组合起来才能发挥最大威力。这里提供几个我常用的命令组合你可以将它们保存为.sh或.bat脚本。1. 一键清理日志并启动应用#!/bin/bash # 假设包名为 com.example.myapp主Activity为 .MainActivity PACKAGE_NAMEcom.example.myapp ACTIVITY_NAME.MainActivity echo “清理旧日志...” adb logcat -c echo “启动应用...” adb shell am start -n “$PACKAGE_NAME/$ACTIVITY_NAME” echo “开始抓取日志按CtrlC停止...” adb logcat -v time | grep —line-buffered “$PACKAGE_NAME”这个脚本在开始测试前先清空日志缓冲区然后启动应用并立即开始过滤显示该应用的日志让你从应用启动的第一刻开始观察。2. 批量安装目录下所有APK#!/bin/bash for apk in ./*.apk; do if [ -f “$apk” ]; then echo “正在安装: $apk” adb install -r “$apk” # -r 覆盖安装 if [ $? -eq 0 ]; then echo “$apk 安装成功” else echo “$apk 安装失败” fi fi done3. 快速获取当前前台应用的包名和Activityadb shell dumpsys window windows | grep -E ‘mCurrentFocus|mFocusedApp’这个命令通过解析窗口管理器信息能快速定位当前正在与用户交互的应用是哪个以及具体的Activity是什么。在测试界面跳转时非常有用。6.3 性能问题初步排查流程当你感觉应用卡顿或设备发热时可以按以下步骤快速收集信息观察整体负载打开一个终端运行adb shell top -d 1 -m 5观察CPU占用最高的几个进程。定位目标应用在另一个终端运行adb shell ps | grep 包名获取应用的PID。分析内存运行adb shell dumpsys meminfo PID重点关注Java Heap和Native Heap的大小以及PSS Total。如果这些值在重复操作后持续增长可能存在内存泄漏。抓取日志同时运行adb logcat -v time | grep 包名过滤出应用日志观察是否有频繁的GC垃圾回收日志或异常。生成报告如果问题复杂最后执行adb bugreport生成一份完整的系统报告供深入分析。6.4 给新手的几点终极建议善用adb —help任何命令后面加上—help都能看到最权威的参数说明比死记硬背更有效。理解命令的“上下文”adb shell后面的命令是在设备上执行的Linux命令不带shell的adb命令如adb install是在主机上执行的ADB客户端命令。区分清楚这一点能避免很多语法错误。输出重定向是好朋友无论是日志还是命令结果尽量重定向到文件 file.txt方便后续查看和分析尤其是logcat和bugreport。安全第一adb shell下的rm、pm uninstall、settings put等命令威力巨大操作前务必确认路径和参数尤其是在拥有root权限的设备上。误删系统文件可能导致设备变砖。保持更新ADB工具包本身也在更新新版本可能会修复旧版本的bug或增加对新设备特性的支持。定期从Android开发者官网更新你的platform-tools。命令是死的场景是活的。最好的学习方式就是在遇到具体问题时带着目标去查阅、尝试和组合这些命令。希望这份融合了命令和经验的指南能成为你手边一份常备的参考让你在驾驭安卓设备时更加得心应手。