我以前一直觉得ADB是搞安卓开发的人才需要碰的命令行工具。直到有一次同事手机上一个App疯狂弹广告又死活卸不掉我顺手用一条adb shell pm uninstall --user 0把它停用了对方看我的眼神立马就不一样了。从那以后ADB在我这儿就从开发工具变成了万能工具箱抓崩溃日志、给电视盒子开调试、替老人手机冻结流氓应用、甚至在无线ADB下远程看看设备的耗电状况。这篇文章就是我这几年用ADB攒下来的实战经验不讲虚的全是文档里翻半天也不一定找得到的细节。1. 先想明白ADB到底是个什么工具1.1 拆开ADB这条命令背后其实是三部分在协作很多教程上来就教adb devices、adb install但从来没解释ADB为什么叫ADB。ADB全称是Android Debug BridgeBridge就是桥连接你电脑和安卓设备的那座桥。它的架构很简单就三块你在电脑终端敲命令用的客户端client、电脑后台常驻的server服务默认监听5037端口、以及真正在设备端干活的adbd守护进程。一条adb devices下去实际上是client把请求交给serverserver再通过USB或者TCP连接把指令递给设备上的adbd执行完毕后原路返回。搞懂这个链路有一个实际意义当你发现adb devices卡住或者超时时多半不是命令写错了而是中间的桥断了——不是server挂了就是adbd没起来再不然是端口被占了。后面的排查章节全部基于这个模型来讲。1.2 ADB擅长和不擅长的事情把ADB当万能钥匙用迟早会踩坑。它擅长的领域很明确应用管理安装、卸载、清数据、停用冻结、文件传输push和pull、界面自动化模拟点击滑动输入、日志抓取logcat、系统参数调整分辨率、密度、刷新率、语言、时区、网络调试无线连接、端口转发。它不擅长的需要指纹、压感这类硬件验证的操作它模拟不了没有root权限时很多系统目录它进不去厂商如果做了限制哪怕命令执行成功也可能没有任何效果。认清边界才能在不该折腾的时候及时收手。1.3 到底哪些人值得花时间学ADB普通用户学会ADB收益其实非常大家里老人的手机装了一堆流氓软件一条pm uninstall --user 0就能禁用掉孩子平板上某些应用卸不干净ADB能直接停用。开发者、测试人员不用多说抓日志、装测试包、模拟点击全是日常操作。还有一类是搞机玩家和运维人员前者拿它刷机管理模块后者拿它批量管理安卓广告屏、收银机、测试机。门槛不高收益却远超想象。就算你只是想知道自己手机里那些莫名其妙的预装App到底在干什么pm list packages这一个命令就够你用一阵子了。2. 环境配置与连接方式这三处最容易卡人2.1 platform-tools版本怎么选PATH怎么配置ADB本身不是安装出来的软件它只是官方SDK Platform Tools压缩包解压就能用的工具集。解压出来有adbWindows下是adb.exe、fastboot这些文件。版本方面很多人喜欢追新我的实际经验是不需要追但也不能太老。老版本可能不了解新手机的加密和认证方式会出现连不上或者传输文件超时的问题新版本功能全但偶尔会和某些厂商魔改的系统有兼容性小毛病。我自己的习惯是每半年到一年从官方渠道下载一次最新版替换平时不折腾。配置PATH是新手第一个卡点。Windows下把platform-tools的绝对路径加进环境变量PathmacOS和Linux下把解压目录加进~/.zshrc或~/.bashrc一行export PATH$PATH:~/platform-tools完事。加完之后新开一个终端窗口敲adb version能显示版本号才算成功。我见过不少人卡在这一步后来发现是旧终端窗口没关PATH没刷新这种细节最容易耗掉新手耐心。2.2 USB连接授权弹窗、驱动识别、还有插拔顺序USB连接是最常见的方式但也是最容易心烦的。手机端先把开发者选项打开小米、红米是设置-我的设备-全部参数与信息-连续点击OS版本号三星是连续点击软件版本号不同品牌入口不一样但套路都是连点版本号七次。进开发者选项后打开USB调试。插上数据线之后手机多半会弹一个是否允许USB调试的对话框勾上始终允许确定。如果电脑端显示unauthorized说明这个弹窗没被正确确认后续有专门章节讲怎么处理。Windows用户还会遇到驱动问题现在的手机基本不用单独装USB驱动但个别老设备或者某些国产ROM需要在开发者选项里手动选择USB配置为RNDIS/传输文件模式才能被系统正确识别。Linux用户要注意设备权限adb devices如果提示no permissions请把设备的vendor id写进udev规则或者临时sudo adb start-server。还有一个容易被忽略的细节优先用原装数据线。很多所谓连不上其实是劣质线只通电不通数据。我工作室里常备好几根原装线就是为了排查问题时少一个变量。2.3 无线ADB摆脱数据线的连接方式无线连接有两种。传统方式是把手机插上USB先执行一遍adb tcpip 5555然后把数据线拔掉在同一WiFi下执行adb connect 手机IP:5555。注意这里有个容易掉坑的点adb tcpip 5555这个命令需要先通过USB连过一次等于给设备开个无线端口重启后会失效。如果你忘了设备IP可以在手机WiFi设置里看或者用adb shell ip addr show wlan0查询。Android 11以后的手机多了一种更省事的无线调试模式开发者选项里开启无线调试再使用配对功能在电脑上执行adb pair IP:端口 配对码配对成功后直接adb connect IP:端口。这个方式不需要先连USB对经常换电脑的人来说非常方便。唯一的坑是端口号是动态的每次开启无线调试都要重新看一眼别把上次的地址当成永久的。2.4 安卓模拟器和电视机的ADB端口差异模拟器的连接方式跟真机完全不一样。以夜神模拟器为例你要先确认模拟器设置里开启了ADB调试然后用adb connect 127.0.0.1:62001连接部分新版本是62025。不同模拟器的端口各不相同网易MuMu通常是7555雷电模拟器早期是5554或5555。每次连不上就先看模拟器启动日志里显示的本机端口别死记硬背。电视、盒子、车机这类设备也走ADB但它们往往没有普通手机那种开发者选项入口有些甚至没有USB口纯靠网络连接。这类设备的连接方式我在第六部分专门展开。3. 连不上的完整排查链从 unauthorized 到 offline3.1 unauthorized授权弹窗没弹出来的真正原因adb devices显示unauthorized是所有新手都会遇到的第一个拦路虎。它的意思很简单设备认出了电脑但还没有确认我信任这台电脑。正常情况下手机上会弹出授权框点允许就行但现实中弹窗经常不出现。原因有几种第一次插线时手快点了取消弹窗被其他应用遮挡了某些国产ROM在息屏状态下根本不弹提示。最直接的解决办法是在手机开发者选项里找到撤销USB调试授权然后拔插数据线重新触发弹窗。如果还是不弹检查一下开发者选项里有没有单独的USB调试安全设置开关比如小米手机必须要打开这个开关才能授予模拟点击权限。这一步经常被人忽略后面自动化操作时会再次用到。3.2 offlineUSB端口、驱动和供电的锅offline比unauthorized更让人抓狂因为设备明明连着但ADB觉得它掉线了。我遇到过很多次后来总结下来offline最常见的原因有三个。第一是USB端口问题。前置USB口、扩展坞、供电不足的hub经常造成传输不稳定换到主机背板上的原生USB口问题直接消失。第二是驱动冲突。Windows上多个厂商驱动打架尤其是老手机插过各种助手软件之后会很随机地出现offline。处理办法是把设备管理器里的Android设备驱动卸载重启电脑让系统重装或者干脆换一台电脑做排除。第三是手机端省电策略把adbd杀了有些国产ROM在息屏后会杀掉后台调试进程。解决方法是开发者选项里开启充电时不熄屏再把ADB相关进程加入后台清理白名单。如果上面都不行万能流派adb kill-server然后拔线、重启手机的USB调试开关再adb start-server重插线。这个流程我在各种奇怪情况下救回来过很多次值得先试一眼。3.3 杀毒软件和adb server版本不一致的问题还有一个非常隐蔽的坑杀毒软件或安全卫士拦截了adb的server。表现是adb devices能启动server但连接设备时提示failed to start daemon或者cannot bind to 5037。因为5037端口是ADB server的固定监听端口有些安全软件会扫描并占用它。用netstat -ano | findstr 5037看一下是哪个进程占着端口通常能发现第三方手机助手或者xx管家。我的建议是凡是装过各种手机助手的电脑先卸载干净再谈ADB。另外一个容易忽视的版本问题如果电脑上同时装了多个平台的adbAndroid Studio自带一个、platform-tools一个、某个模拟器又带一个它们之间server协议可能不一致。排查办法是看adb version显示的路径是哪个然后统一用一个版本的adb把其他路径从PATH里去掉。4. 日常最高频的命令按场景整理好4.1 应用安装、卸载和清数据装了ADB之后第一件值得做的事就是替代手机上的各种安装器。adb install -r app.apk-r表示覆盖安装保留数据开发测试时加-d允许降版本加-g可以一次性授予所有运行时权限。卸载更干脆adb uninstall com.xxx.xxx连残留数据一起清掉。要是只想清数据不想卸载用adb shell pm clear com.xxx.xxx这个命令对解决应用状态错乱很有效比如某个App卡在登录页死活进不去清一下数据反而恢复正常。强制停止应用是adb shell am force-stop com.xxx.xxx相当于在系统层面杀掉进程比在应用列表里点强行停止更彻底也适合那些会自动重启的顽固应用。但是要注意force-stop之后应用还会被其他事件唤醒想根治还得靠下面的冻结功能。4.2 冻结与解冻应用以红米K70为例冻结是我想推荐给普通用户的功能之一。命令是adb shell pm disable-user --user 0 com.xxx.xxx含义是对当前用户禁用某个应用系统会把它从启动器里藏起来也不会再自启动。解冻用adb shell pm enable com.xxx.xxx。把已冻结的应用列出来用adb shell pm list packages -d这个命令能随时提醒你之前到底冻结了哪些东西。很多人在问红米K70能不能用ADB冻结应用。实测结论是HyperOS保留了pm disable-user的能力很多内置应用都能冻结比如系统更新、自带商店、浏览器。但有几点必须注意不要冻结系统核心组件比如com.miui.securitycenter、com.android.systemui冻结系统UI的后果是桌面和状态栏一起消失只能重启救回来冻结后某些高权限应用还能唤起被禁用应用想要更彻底的停用得走root之后的包管理那是另一个话题。不同品牌的包名前缀不一样vivo是com.vivo.、com.bbk.OPPO是com.oplus.、com.heytap.小米以com.miui.*为主动手之前先adb shell pm list packages全量列出来看看哪些是不认识的内置包再挨个确认用途。不要图省事一键冻结一堆出了问题光排查就够你喝一壶。4.3 文件双向传输与截图录屏adb push 本地文件 手机目录和adb pull 手机文件 本地目录是ADB最朴实的两个命令。我平时用它们给设备装协议包、导出日志、提取配置。一个特别推荐的小技巧是截图adb exec-out screencap -p screen.png直接把截图输出到电脑不用在手机里存储再拉回来。不过Windows用户要小心PowerShell会把二进制输出搞乱推荐用cmd或者Git Bash或者干脆走两步adb shell screencap -p /sdcard/s.png存到手机再adb pull /sdcard/s.png。录屏是adb shell screenrecord --time-limit 10 /sdcard/test.mp4可以在不碰手机的情况下录制屏幕默认最长180秒可以自己指定时长。用它记录复现bug的过程、给家人写操作教程比在手机上装录屏软件靠谱得多还能省下手机CPU资源录出来的画面帧率也更稳。4.4 用appops限制应用联网普通手机上限制单个应用联网多数厂商系统自带联网控制但很多老设备或国外ROM没有。ADB给了另一条路adb shell cmd appops set com.xxx.xxx INTERNET ignore让应用以为设备完全没有网络。这个命令在Android 10以上的原生系统上实测有效但对国产ROM的兼容性不一有的ROM会无视appops设置有的应用断网后会崩溃。所以我的建议是先用它做临时测试长期限制还是优先用系统自带的联网控制毕竟那是在防火墙层做的更可靠也更不容易被应用检测到。另外appops还能设置其他权限比如使用情况访问权限adb shell appops set com.xxx.xxx GET_USAGE_STATS allow可以绕过很多权限页面的手动开关这在自动化测试和隐私类App调试时很有用。5. logcat 实战会过滤比会刷屏更重要5.1 过滤的基本规则标签、等级、关键字第一次跑adb logcat的人都会被刷屏吓到——整个系统的日志多到根本看不过来。真正的用法是过滤。最常用的是按标签过滤adb logcat -s 你的标签标签是Android日志里的第一列通常是应用自己声明的TAG。你可以先跑一次adb logcat找到关注的行再按标签重跑。按等级过滤也常用adb logcat *:E只显示Error级别*:W显示警告和错误*:S是静默模式。组合起来就是只看某个标签的错误adb logcat -s 标签:E。按关键字过滤在Windows上用adb logcat | findstr 关键字macOS和Linux上用adb logcat | grep 关键字。管道命令会一直运行看完记得CtrlC终止。5.2 抓崩溃现场和ANR想让崩溃日志更干净可以只抓崩溃缓冲adb logcat -b crash。这个缓冲专门放崩溃信息抓的时候配上时间戳更利于分析adb logcat -b crash -v time。如果应用出现ANR日志里会有一大段ANR in ...开头的输出后面跟着主线程的调用栈。ANR日志是定位卡顿的钥匙但默认logcat缓冲可能已经滚动掉了所以更稳妥的做法是提前把日志重定向到文件复现问题后再分析。对于需要复现的bug我习惯先把logcat缓冲清空adb logcat -c让用户或者自己复现一次再用adb logcat -d -b crash crash.log把当时的崩溃栈导出来。-d表示dump后退出不会一直阻塞适合事后取证。5.3 保存与分析从刷屏日志里找到真正的根因保存日志最直接的方式是重定向adb logcat app.log。但这里有个大坑手机上其他应用也在打日志你只想看自己关心的就要先过滤再保存。我常用的组合adb logcat -v time -s 标签:* *:S focused.log只保存某个标签的所有级别日志带时间戳方便后续分析。分析的时候别只盯着崩溃堆栈那几十行前面几秒的日志往往藏着前因可能是某个服务的调用被拒绝可能是权限被系统回收可能是资源文件加载失败。另外现在的Android版本对应用日志有可见性限制非root状态下抓不到别的应用私有标签的日志这是系统设计不是命令写错。需要深度分析某个应用的全部日志时要么用支持adb root的工程机或模拟器要么就靠应用自己在文件里记日志。6. 系统级调试刷新率、权限授予、自动化操作6.1 wm命令改分辨率和刷新率adb shell wm系列是调整显示参数的利器。改分辨率用adb shell wm size 1080x2400改密度用adb shell wm density 420恢复原样用wm size reset和wm density reset。它们特别适合游戏测试和功耗测试场景比如把测试机降到720P跑一轮功耗再切回1080P。要注意的是改分辨率后桌面会重排部分应用布局会乱这只是显示层的缩放不影响真实硬件参数重启设备后恢复。刷新率是近几年热门话题。很多机型为了省电默认锁在60Hz或者智能切换想验证高刷效果可以用adb shell settings put system peak_refresh_rate 120配合adb shell settings put system min_refresh_rate 120把刷新率锁到120Hz。但不同厂商ROM习惯不同有的用settings put system refresh_rate有的用settings put global还有的在开发者选项里提供了显示刷新率开关命令反而全无效。我的做法是先adb shell settings list system | grep refresh看看系统里实际的键名再对症下药。6.2 命令行授予运行权限和无障碍权限给应用授予运行时权限通常要到设置里手动点ADB可以一条命令完成adb shell pm grant com.xxx.xxx android.permission.CAMERA。它本质上模拟了用户在权限弹窗里点允许。这适合批量授权和测试场景免去反复点击的麻烦。要注意的是pm grant只能授予dangerous级别的权限签名权限和特殊权限它管不了。无障碍权限是另一个高频需求。很多人问ADB如何授予应用无障碍权限答案是用settings命令写系统配置先把无障碍服务组件名查出来用adb shell dumpsys package com.xxx.xxx | grep -A 3 AccessibilityService或者从应用文档里找然后执行adb shell settings put secure enabled_accessibility_services com.xxx.xxx/com.xxx.AccessibilityService再执行adb shell settings put secure accessibility_enabled 1。这个操作对自动化工具来说很关键因为很多模拟点击框架必须先拿到无障碍节点信息。但要注意部分App会校验无障碍权限是否由用户亲手开启用ADB写进去之后功能可能依然不生效特别是银行类和安全类应用。6.3 input模拟点击与定时脚本能做的事adb shell input系列是可以直接模拟用户操作的命令adb shell input tap x y模拟点击adb shell input swipe x1 y1 x2 y2 时长模拟滑动adb shell input text 内容输入文字adb shell input keyevent 27模拟拍照键26是电源键4是返回3是Home。要准确点击某个按钮需要知道坐标。最偷懒的方法是打开开发者选项里的指针位置屏幕上会实时显示触摸坐标要更精确地定位UI元素可以用adb shell uiautomator dump导出当前界面的布局XML然后从XML里找控件的bounds。这套组合拳就是很多自动点击脚本的原型。网上经常见到adb 企业微信 自动打卡之类的需求本质就是把input tap和定时任务结合起来在固定时间自动点击按钮。这类自动化脚本抛开合规问题不谈单说技术就有几个门槛界面变化会导致坐标失效真正的生产级脚本必须结合无障碍获取文本节点来判断而且涉及企业考勤我建议不要拿个人的ADB技能去走这种擦边球容易惹上不必要的麻烦。自己写脚本抢个消费券、自动签个到这类事倒是可以放心折腾。6.4 老电视和盒子开ADB的常见入口电视、盒子上的ADB跟手机很不一样。很多老款电视没有标准的开发者选项入口菜单可能藏在关于本机-版本号连续点击或者按遥控器上的特定组合键进入工程菜单。比如老款创维电视有的型号要在设置-通用设置里开ADB调试有的型号必须进入工厂菜单才能看到开关还有些只能通过串口或者局域网的ADB远程调试端口连接。连接方式上电视通常只能走无线在电视上打开网络调试记下IP电脑执行adb connect 电视IP:5555。有些电视的连接端口不是默认的5555是厂商自定义的比如5025、6222这类遇到连不上可以试试常见端口或者查设备说明书。另外不少电视重启之后会自动关闭ADB这大概就是电视机永久打开adb这个需求出现的原因如果能在工程模式里开启一般会记住状态比每次重启后手动重开省事得多。还有一类设备比较特殊开启无线ADB时会要求输入动态密码密码每隔一段时间会变需要使用动态密码计算器这类工具根据设备码生成。这类设备基本都是厂商为了防止普通用户开启ADB做的限制。我的建议是遇到这种情况先找官方渠道要调试权限强行绕过厂商验证可能让设备失去质保甚至变砖为省这点事冒大风险不划算。7. 那些只会在实战里踩到的坑7.1 /data/adb 目录里有什么能不能动很多玩过root和Magisk的人会注意到设备里有/data/adb这个目录下面还有modules和modules_update。这里我得先说明白这个/data/adb和ADB调试根本是两码事它只是Magisk运行时把模块目录放在了这个方便记忆的位置。modules是当前生效的模块modules_update是等待更新的模块Magisk在更新模块时会先把新包暂存在update目录重启后再应用。没事别直接往这两个目录里手动写文件模块之间有依赖关系手动改坏了一个轻则某个模块失效重则开机卡在Logo。模块的启停要在Magisk应用里操作。如果你看到一些名字看起来和设备指纹、密钥相关的目录说明设备上装了某个系统完整性相关的模块。这类玩法属于灰色地带我不建议普通用户为了绕过应用检测去安装搞懂系统机制是一回事主动规避安全校验是另一回事。7.2 ADB的权限边界与厂商限制ADB再强大本质还是系统给调试者开的一道门。厂商可以关掉这道门也可以给门加锁。比如很多国产品牌在正式版ROM里对pm disable-user做了白名单限制不是你指定冻结谁就冻结谁有些品牌禁止无线ADB的tcpip方式只开放系统自带的无线调试还有的品牌在adb install时强制校验签名非官方渠道的包会被拦下来。遇到这种厂商限制正确思路不是硬碰硬而是先确认设备是否解锁了Bootloader、是否允许root。比如前面提到的红米K70如果你愿意解锁BL并刷入root环境冻结应用的限制会小很多。但解锁Bootloader通常意味着放弃官方保修部分系统级安全功能也会失效这些取舍只能自己权衡。作为一个常年和ADB打交道的人我的体会是能用ADB解决的问题先别急着想rootADB解决不了的再评估要不要解锁这才是最稳妥的路径。7.3 几个我每次重装系统都会翻出来的小技巧最后分享几个我这些年来攒下的习惯。第一adb devices长时间没反应先adb kill-server再adb start-server这个组合拳能解决一半以上的玄学问题。第二不同电脑、不同手机混用之后记得在手机开发者选项里定期清理已授权的电脑列表保持授权列表干净能避免很多莫名其妙的连接问题。第三批量管理多台设备时用adb -s 设备序列号 shell 命令指定设备操作不然命令会不知道自己该跑哪台机器。第四调试完记得关掉USB调试和无线调试特别是连接过陌生电脑之后这是基本的安全习惯别嫌麻烦。ADB用久了你会发现它根本不是什么高深的技术而是一套你给系统一次信任系统还你一片自由的调试通道。学会它最大的收获不是省了多少时间而是当手机、电视或者测试设备出问题时你手里多了一把能自己动手处理的螺丝刀。想在安卓生态里少被各种助手管家牵着走从学会这几条命令开始很值。