1. 项目概述为什么我们需要系统化地掌握ADB命令作为一名在Android开发和测试领域摸爬滚打了十多年的老手我见过太多同行和新人面对ADBAndroid Debug Bridge时那种“又爱又恨”的状态。爱的是它确实是连接电脑与Android设备、进行深度调试和自动化操作的“瑞士军刀”恨的是它的命令繁多参数复杂很多命令用过就忘每次用到都得临时去查效率极低。网络上零散的“常用命令列表”往往只给命令不讲场景和原理更别提那些只有踩过坑才知道的细节和技巧了。所以今天我想做的不是简单地罗列另一个命令清单。而是基于我这些年在一线开发、测试、甚至处理用户设备问题中积累的经验为你系统性地梳理ADB命令的“知识图谱”。我们将从“连接管理”这个最基础也最容易出错的环节开始深入到“应用生命周期管理”、“文件与日志操作”、“设备信息与性能洞察”最后到“高级调试与自动化”场景。我的目标是让你读完这篇文章后不仅能记住命令更能理解每条命令背后的设计逻辑、适用场景以及那些官方文档里不会写的“坑点”和“骚操作”。无论你是刚入门的新手还是想提升效率的资深开发者这份总结都能成为你手边随时可查、可信赖的实战指南。2. 基石篇设备连接与认证——一切操作的前提所有ADB魔法都始于一个稳定的连接。这一步看似简单却拦住了至少50%的初学者。很多人卡在这里然后就去搜索各种“无法连接”的解决方案其实根源在于对连接机制理解不透。2.1 连接方式的本质与选型ADB连接设备主要有三种方式USB、网络Wi-Fi和无线调试Android 11。每种方式背后都是不同的通信协议和适用场景。USB连接是最经典、最稳定的方式。它的本质是电脑通过USB数据线与设备上的adbdADB守护进程建立直接的Socket通信。稳定性高延迟低是进行刷机、获取root权限等高危操作的首选。但缺点是被线缆束缚。网络连接TCP/IP让你摆脱线缆。其原理是设备与电脑处于同一局域网下设备端的adbd开启一个TCP端口默认5555电脑通过IP地址和端口号与之通信。它的优势是灵活适合需要频繁插拔设备或设备固定在某个位置的场景。但稳定性受网络质量影响且存在安全风险同一网络下的其他机器理论上也能连接。无线调试Android 11是谷歌官方强推的现代化连接方式。它通过配对码一个六位数字在电脑和设备间建立加密的、点对点的Wi-Fi连接无需设备与电脑处于同一网络也无需先通过USB线初始化。这极大地提升了无线调试的安全性和便捷性。可以把它理解为“经过身份认证的、更安全的网络ADB”。实操心得对于日常开发我强烈推荐使用无线调试。在Android Studio的Logcat窗口旁边就有无线调试的快速配对按钮体验丝滑。对于测试或需要稳定连接的场景备一根质量好的USB线永远没错。网络ADB适合临时性的文件传输或日志查看。2.2 核心连接命令详解与避坑指南掌握了原理我们来看命令。很多人只知道adb devices但背后的故事远不止如此。adb devices这是你的“雷达”。它会列出当前所有连接到ADB服务器的设备列表。输出格式通常是List of devices attached emulator-5554 device 192.168.1.100:5555 device第一列是设备的序列号对于USB是硬件序列号对于模拟器是端口对于网络是IP:端口第二列是状态device-已授权offline-设备未响应unauthorized-未授权。当你看到unauthorized时意味着设备上弹出了“允许USB调试吗”的对话框而你还没点击“确定”。这是最重要的安全机制之一。adb connect ip[:port]用于发起网络连接。例如adb connect 192.168.1.100:5555。这里有个关键点设备必须先通过USB连接一次并执行adb tcpip 5555命令让设备的adbd重启并在5555端口监听之后才能断开USB进行无线连接。对于Android 11的无线调试这个步骤被配对流程替代了。adb disconnect [ip[:port]]断开指定或所有网络连接。adb kill-server/adb start-server这是解决很多玄学问题的“重启大法”。adb kill-server会终止电脑上的ADB服务进程adb start-server会启动它。当你遇到设备列表莫名消失、连接不稳定、命令无响应时先尝试adb kill-server然后重新插拔设备或执行adb devices它会自动触发服务启动十有八九能解决问题。adb usb这个命令常被误解。它的作用是将当前通过网络连接的设备切换回USB模式前提是设备正通过USB线连接着。如果设备只连着Wi-Fi这个命令会报错。踩坑记录“设备离线offline”最常见于USB连接。原因可能是数据线质量差只能充电不能传数据、电脑USB口供电不足、或者设备驱动未正确安装。解决方案换一根确认能传输数据的数据线换一个USB口在设备管理器中检查Android设备驱动。“无法找到设备device not found”执行adb devices为空。检查USB调试是否开启开发者选项里检查设备是否被其他程序占用如手机助手、豌豆荚尝试adb kill-server。网络连接突然断开设备Wi-Fi休眠或IP地址变更。为设备设置“在充电状态下保持Wi-Fi连接”或考虑使用静态IP。对于频繁断线还是回归USB更稳妥。3. 核心应用操作安装、卸载与生命周期控制连接稳定后我们最常做的就是对应用APK进行操作。这部分命令是开发测试的日常但细节决定成败。3.1 应用安装的三种模式与选择安装命令adb install后面跟着不同的参数代表了不同的安装策略adb install path_to_apk默认安装。如果设备上已存在同包名的应用安装会失败。你必须先卸载旧版本。adb install -r path_to_apk覆盖安装Replace。这是我最常用的参数。保留应用数据直接安装新版本。用于应用升级测试非常方便。但注意如果新版本签名和旧版本不一致覆盖安装会失败这是Android的安全机制。adb install -t path_to_apk允许测试包Allow test。用于安装声明了android:testOnlytrue的APK。这类APK通常是通过Android Studio直接Run出来的调试版本。如果你直接安装一个testOnly的APK而不加-t会失败。adb install -d path_to_apk允许版本降级Downgrade。默认情况下安装版本号低于设备现有版本的APK会失败。此参数强制允许降级常用于验证旧版本的问题或进行版本回退测试。adb install -g path_to_apk授予所有运行时权限Grant all permissions。在Android 6.0API 23及以上危险权限需要运行时申请。此参数会在安装时自动授予APK清单文件中声明的所有权限对于自动化测试非常有用可以避免测试脚本被权限弹窗打断。实操心得组合使用参数是常态。例如我日常测试升级流程的命令是adb install -r -g myapp-debug.apk。这样既能覆盖安装又自动处理了权限一步到位。另外安装时注意APK路径不要有中文或空格否则需要用引号包起来。3.2 应用卸载的“温柔”与“彻底”卸载同样有学问主要区别在于是否保留数据和缓存。adb uninstall package_name标准卸载。删除应用但保留其数据目录/data/data/package_name。这对于调试数据相关的问题有时有用你可以卸载应用再安装数据还在。adb uninstall -k package_name保留数据和缓存卸载。-kkeep参数会卸载应用但保留其所有数据包括/data/data/和缓存。这个命令在你想清除应用本身但保留其产生的用户数据如游戏存档时有用但实际开发中较少使用因为一个行为异常的应用其数据也可能是有问题的。真正彻底的清理很多时候仅仅卸载是不够的特别是应用产生了异常数据或你想完全重置它。这时需要组合拳adb uninstall package_name先正常卸载adb shell pm clear package_name清除残留的数据和缓存pm clear命令非常强大它会清空应用的所有持久化数据和缓存效果等同于用户在系统设置里点击“清除数据”和“清除缓存”。这在测试应用首次启动逻辑时是必备操作。3.3 应用调起、停止与组件管理除了安装卸载控制应用运行状态同样关键。adb shell am start这是活动管理器Activity Manager的命令用于启动一个Activity。最完整的格式是adb shell am start -n package_name/activity_full_name例如adb shell am start -n com.example.myapp/.MainActivity你还可以添加Intent参数例如-a android.intent.action.VIEW -d http://www.example.com来用浏览器打开网页。adb shell am force-stop package_name强制停止一个应用。这比在最近任务里划掉更彻底它会终止应用的所有进程和服务。在测试应用被系统回收后重新启动的场景时常用。adb shell am broadcast发送一个广播。用于测试广播接收器。例如adb shell am broadcast -a com.myapp.action.TEST。adb shell pm path package_name获取已安装APK在设备上的存放路径。输出类似package:/data/app/com.example.myapp-xxx/base.apk。这个路径可以用来将APK从设备拉取到电脑进行分析。注意事项am和pm命令都需要在adb shell环境下执行或者写成adb shell am ...的形式。它们是与Android系统框架深度交互的命令功能极其强大但也需要谨慎使用特别是在生产设备上。4. 文件与日志开发者的“眼睛”和“手”调试离不开看日志也离不开在设备和电脑间传输文件。这部分命令是你的日常工具。4.1 文件传输push与pull的细节adb push local remote将文件从电脑推送到设备。例如adb push ./update.zip /sdcard/。adb pull remote [local]将文件从设备拉取到电脑。例如adb pull /sdcard/error.log ./。这里有几个至关重要的细节路径问题如果路径包含空格必须用引号括起来如adb push my file.txt /sdcard/Download/。权限问题普通应用非root只能向/sdcard/外部存储或应用自己的数据目录/data/data/package/写入文件。尝试向/system等系统目录push文件会因权限不足而失败。文件夹操作push和pull默认支持整个文件夹的递归传输。例如adb pull /sdcard/DCIM ./photos会把整个DCIM文件夹拉取到本地的photos目录下。性能与进度传输大文件时ADB会显示进度。如果传输中断文件可能会不完整。对于关键文件传输后可以用adb shell md5sum file和本地的md5sum校验一下一致性。4.2 日志抓取从Logcat到更专业的方案adb logcat这是最基础的日志查看命令。但直接使用它会瞬间刷出海量信息。高效使用Logcat的技巧按标签过滤adb logcat -s TAG_NAME。例如adb logcat -s MyApp只显示标签为“MyApp”的日志。你需要在代码里用Log.d(“MyApp”, “message”)来定义标签。按优先级过滤adb logcat *:优先级。优先级从低到高有V(Verbose),D(Debug),I(Info),W(Warn),E(Error),F(Fatal)。adb logcat *:E只显示错误日志在排查崩溃时非常有用。组合过滤adb logcat -s MyApp:E显示MyApp标签下优先级为Error及以上的日志。清空日志缓冲区adb logcat -c。在开始复现问题前清空旧日志能让抓取的日志更干净。将日志输出到文件adb logcat -d log.txt。-d参数表示抓取当前缓冲区所有日志然后退出非常适合一次性抓取。持续输出到文件adb logcat -f /sdcard/log.txt。这个命令会让日志持续写入设备的文件中适合长时间监控。注意用CtrlC终止。更专业的日志方案——bugreport当遇到复杂问题特别是涉及系统层面如ANR、系统服务死锁、功耗异常时logcat可能不够。这时需要adb bugreport。 这个命令会触发设备生成一个包含大量诊断信息的ZIP文件包括完整的logcat和内核日志dmesg系统服务状态dumpsys所有服务进程状态ps文件系统信息ANR应用无响应 traces文件错误报告dumpstate生成后ADB会自动将这个ZIP文件拉取到电脑当前目录。你可以用adb bugreport output_dir指定输出目录。分析bugreport需要一些经验但它是提供给谷歌或芯片厂商排查问题的标准材料。踩坑记录logcat缓冲区是有限的高频率的日志打印比如在循环里每秒打几百条Log.v会导致旧的日志被快速冲掉你可能还没反应过来关键的日志就没了。因此在打日志时要有所取舍关键路径用Log.i或Log.w避免滥用Log.v。对于必现的复杂问题直接上bugreport。5. 设备信息获取与系统交互了解设备状态是调试的基础。这部分命令帮你快速给设备“体检”。5.1 获取基础设备信息adb shell getprop这是信息宝库。它会列出设备的所有系统属性build.prop等。我们通常用grep来过滤需要的信息adb shell getprop ro.product.model获取设备型号如“Pixel 6”。adb shell getprop ro.build.version.release获取Android版本如“13”。adb shell getprop ro.serialno获取设备序列号。adb shell getprop ro.build.fingerprint获取构建指纹用于唯一标识一个系统版本。adb shell wm size获取屏幕物理分辨率如“1080x1920”。adb shell wm density获取屏幕密度DPI如“420”。adb shell dumpsys battery获取详细的电池信息包括状态充电中、放电、电量百分比、健康状况、温度等。在测试功耗相关功能时非常有用。5.2 深入系统状态dumpsys命令族dumpsys是adb shell下的一个强大工具用于转储dump系统服务的信息。它的输出非常详细是高级调试的利器。adb shell dumpsys activity查看Activity栈信息。可以知道当前前台是哪个应用、哪个Activity。常用的子命令有adb shell dumpsys activity activities详细的活动栈信息。adb shell dumpsys activity recents最近任务列表。adb shell dumpsys meminfo package_name查看指定应用的内存使用详情包括Java堆、Native堆、PSS等。这是分析内存泄漏和优化内存的必备命令。adb shell dumpsys cpuinfo查看CPU使用情况。adb shell dumpsys gfxinfo package_name查看应用渲染性能数据可以分析界面是否卡顿。需要结合开发者选项中的“GPU渲染模式分析”使用。adb shell dumpsys package package_name查看指定应用的完整安装信息包括版本号、权限、组件、签名等。adb shell dumpsys window查看窗口管理器信息包括当前焦点窗口、显示信息等。实操心得dumpsys的输出通常非常冗长。我常用的技巧是结合grep进行过滤或者将输出重定向到文件慢慢分析。例如想快速看某个应用的内存概况adb shell dumpsys meminfo com.example.myapp | grep -E “(TOTAL|Java Heap|Native Heap)”。5.3 模拟用户输入与硬件事件ADB可以模拟几乎所有的硬件按键和触摸输入这对于自动化测试和演示非常有用。adb shell input命令族文本输入adb shell input text “HelloWorld”。注意它无法输入中文除非设备安装了特定输入法并已切换且不能输入空格空格需要用%s表示。按键事件adb shell input keyevent keycode。KEYCODE_HOME3KEYCODE_BACK4KEYCODE_ENTER66KEYCODE_VOLUME_UP24KEYCODE_VOLUME_DOWN25KEYCODE_POWER26 例如adb shell input keyevent 26模拟按下电源键。触摸与滑动adb shell input tap x y在坐标(x, y)处点击。adb shell input swipe x1 y1 x2 y2 [duration(ms)]从(x1,y1)滑动到(x2,y2)可指定持续时间默认是毫秒级快速滑动。长按可以通过在一个点附近小范围滑动或使用input swipe x y x y 2000持续2秒来模拟。获取坐标可以通过开发者选项中的“指针位置”功能开启。这些命令是编写简单ADB自动化脚本的基础。6. 高级调试与自动化实战技巧掌握了基础命令我们可以组合它们解决更复杂的问题甚至实现简单的自动化。6.1 屏幕截图与录屏截图adb shell screencap -p /sdcard/screenshot.png然后将图片拉取到电脑adb pull /sdcard/screenshot.png。更快捷的一行命令是adb exec-out screencap -p screenshot.png注意exec-out参数用于直接输出二进制数据到标准输出适合脚本化。录屏adb shell screenrecord /sdcard/demo.mp4。录制默认最长3分钟分辨率是设备分辨率码率默认4Mbps。可以用参数调整--size WIDTHxHEIGHT设置分辨率如--size 720x1280。--bit-rate RATE设置码率如--bit-rate 20000002Mbps。--time-limit TIME设置时长秒。--verbose输出日志信息。 按CtrlC停止录制然后adb pull拉取视频文件。注意screenrecord需要Android 4.4API 19及以上且无法录制受DRM保护的内容或安全屏幕如密码输入界面。6.2 Shell环境下的深度操作进入adb shell后你就获得了一个Android设备的Linux Shell。这里可以执行大部分标准的Linux命令如ls,cd,cat,ps,top,grep,find,chmod,chown等。这对于深入排查问题至关重要。查看进程adb shell ps或adb shell ps -A查看所有进程。结合grep过滤adb shell ps | grep myapp。查看实时资源占用adb shell top。类似于Linux的top命令可以查看CPU、内存占用最高的进程。查找文件adb shell find /data -name “*.db”在/data分区查找所有数据库文件。查看文件内容adb shell cat /proc/cpuinfo查看CPU信息。adb shell cat /proc/meminfo查看内存信息。重要警告在shell下尤其是拥有root权限后操作需要极其小心。错误的rm或chmod命令可能导致系统无法启动。永远不要在生产设备或重要设备上执行你不完全理解的shell命令。6.3 组合命令与简单脚本ADB命令的强大之处在于可以组合和脚本化。命令组合使用前一个命令成功才执行下一个或;无论前一个命令成功与否都执行下一个。 例如清空应用数据并重启它adb shell pm clear com.example.myapp adb shell am start -n com.example.myapp/.MainActivity编写Shell脚本你可以将一系列ADB命令写在一个.shMac/Linux或.batWindows文件中。 例如一个简单的自动化测试脚本test.batecho off echo 正在安装应用... adb install -r -g app-debug.apk echo 正在启动应用... adb shell am start -n com.example.myapp/.MainActivity timeout /t 5 echo 正在模拟点击... adb shell input tap 500 1000 echo 正在截图... adb exec-out screencap -p result.png echo 测试完成使用Python/Node.js等脚本语言对于更复杂的自动化可以用编程语言调用ADB命令。例如用Python的subprocess模块import subprocess def run_adb(cmd): result subprocess.run(fadb {cmd}, shellTrue, capture_outputTrue, textTrue) return result.stdout device_model run_adb(shell getprop ro.product.model).strip() print(f当前设备型号{device_model})6.4 无线调试与多设备管理无线调试Android 11新流程确保设备和电脑连接到任意可用的Wi-Fi网络甚至可以一个是手机热点另一个是家庭Wi-Fi。在设备的开发者选项中找到“无线调试”开启它。点击“使用配对码配对设备”会显示一个六位数的配对码和IP地址端口如192.168.1.100:37173。在电脑终端执行adb pair 192.168.1.100:37173然后输入屏幕上显示的配对码。配对成功后无线调试列表中会显示设备并给出一个连接端口如192.168.1.100:40811。执行adb connect 192.168.1.100:40811即可连接。多设备管理当连接了多个设备包括模拟器时执行任何ADB命令都需要指定目标设备否则ADB会报错error: more than one device/emulator。 指定设备有两种方式使用设备序列号在每个命令前加上-s serial。例如adb -s emulator-5554 install app.apk。设置环境变量一次设置后续命令默认生效。Mac/Linux:export ANDROID_SERIALemulator-5554Windows (CMD):set ANDROID_SERIALemulator-5554Windows (PowerShell):$env:ANDROID_SERIALemulator-5554我个人习惯在脚本中明确使用-s参数避免环境变量带来的意外。7. 常见问题排查与命令速查表即使经验丰富也会遇到各种奇怪的问题。这里记录一些我反复遇到的“坑”及其解决方案。7.1 连接与权限类问题问题adb devices显示设备为unauthorized。排查检查设备屏幕是否弹出“允许USB调试”的RSA密钥指纹对话框点击“确定”。如果没弹出尝试重新插拔USB线或重启adb server(adb kill-serverthenadb start-server)。有时需要检查开发者选项中的“USB调试”是否被意外关闭。问题USB连接正常但网络adb connect失败。排查确认设备IP地址是否正确且电脑与设备在同一局域网。确认设备端adbd是否在TCP/IP模式监听是否执行过adb tcpip 5555执行后设备端的ADB会重启。检查防火墙电脑或路由器的防火墙可能屏蔽了5555端口。对于Android 11请使用新的无线调试配对流程而非旧的adb tcpip方式。问题执行adb shell某些命令如rm /data/system/xxx提示Permission denied。排查该命令需要root权限。首先确认设备是否已rootadb shell后提示符是否为#。如果是$尝试执行adb root。如果adb root失败说明设备的adbd不是以root身份运行或者设备本身未获取root权限。对于生产设备或非root设备很多系统目录是无法访问的。7.2 应用与文件操作类问题问题adb install失败提示INSTALL_FAILED_UPDATE_INCOMPATIBLE。排查新APK的签名与设备上已安装版本的签名不一致。Android禁止覆盖安装签名不同的APK。解决方案先adb uninstall卸载旧版本再安装或者确保打包APK时使用相同的签名密钥。问题adb install失败提示INSTALL_FAILED_TEST_ONLY。排查APK是测试版android:testOnlytrue。使用adb install -t参数安装或者修改构建配置生成非测试版APK。问题adb push文件到/data/local/tmp失败提示只读文件系统。排查/data分区通常需要root权限才能写入。尝试adb root后再次执行。或者将文件推送到sdcard目录。7.3 命令速查表按场景分类为了方便查阅我将最核心的命令整理成下表场景命令说明与常用参数连接管理adb devices列出已连接设备adb connect ip:port连接网络设备adb disconnect断开网络连接adb kill-server重启ADB服务万能药adb pair ip:port(Android 11) 无线配对应用安装adb install -r -g apk最常用覆盖安装并授权adb install -t apk安装测试版APKadb uninstall package卸载应用保留数据adb shell pm clear package彻底清除应用数据应用控制adb shell am start -n pkg/act启动Activityadb shell am force-stop pkg强制停止应用adb shell am broadcast -a action发送广播文件操作adb push local remote电脑-设备adb pull remote local设备-电脑日志抓取adb logcat -s TAG:E按标签和级别过滤日志adb logcat -d log.txt抓取日志到文件adb bugreport抓取完整系统报告设备信息adb shell getprop [key]获取系统属性adb shell wm size屏幕分辨率adb shell dumpsys meminfo pkg应用内存详情模拟输入adb shell input text “abc”输入文本adb shell input keyevent KEYCODE模拟按键adb shell input tap x y模拟点击adb shell input swipe x1 y1 x2 y2模拟滑动截图录屏adb exec-out screencap -p shot.png截图到电脑adb shell screenrecord /sdcard/demo.mp4录屏设备端Shell常用adb shell ps | grep pkg查找进程adb shell top实时资源监控adb shell pm path pkg获取APK路径最后我想分享一个最深刻的体会ADB不是用来死记硬背的而是用来理解和组合的。最好的学习方式不是收藏这篇文章而是打开你的终端连接上你的测试设备或模拟器把每条命令都敲一遍观察它的输出和效果。遇到错误不要慌仔细读错误信息它往往已经给出了线索。当你把这里列出的命令都亲手实践过并且成功用它们组合脚本解决过一个实际问题时这些命令才真正属于你。工具的价值永远在于用它的人。