1. ADB到底是个啥以及装好它的正确姿势1.1 先搞明白ADB不是“一键刷机”那种黑科技很多刚接触安卓开发或者喜欢折腾手机的朋友第一次听到“ADB”都会觉得这玩意儿挺神秘。其实说白了ADBAndroid Debug Bridge就是安卓系统和电脑之间的一座调试桥梁它让你能在电脑的命令行窗口里直接向手机下发各种操作指令。不管是装应用、传文件、抓日志还是修改一些系统层级的设置只要手机开了USB调试模式ADB几乎都能帮你搞定。它为什么重要因为安卓系统本身就是一个半封闭的系统很多系统内部的接口和状态普通用户从手机屏幕上根本看不到也没法直接操作。ADB相当于给了你一把“后台管理钥匙”你可以像管理服务器一样去管理你的安卓设备。对开发者来说它是最基础的调试工具对喜欢折腾的玩家来说它也是实现各种“骚操作”的入口。新手刚开始接触ADB最容易犯的毛病是觉得它很难迟迟不敢动手。实际上你用熟了就能发现它来来去去就那么二三十个高频命令原理也不复杂。这篇文章就是把我自己从“看到命令行就头疼”到“用ADB解决各种实际问题”这段过程里的经验整理出来尤其是那些网上教程里很少讲到的细节和坑。1.2 环境配置Windows、macOS、Linux三种系统怎么装最快先说结论别卡在环境配置这一步它是整个ADB使用中门槛最低但最劝退新手的一环。配置方式各大系统有差异我给你拆开说。在Windows上最省心的办法是直接用“15 seconds ADB Installer”这种一键安装包。名字很直白15秒装完它会把ADB驱动和平台工具一起装好自动配好环境变量装完之后在任意目录打开命令行输入adb version能出来版本号就说明成功了。我自己给装系统的朋友推过很多次这个方案确实省事。如果你不想用第三方安装包那就手动配置。去安卓开发者官网下载Platform Tools压缩包解压到一个路径里比如D:\platform-tools然后右键“此电脑” → 属性 → 高级系统设置 → 环境变量在Path里新建一行把这个路径加进去。这里注意一个细节添加环境变量后必须新开一个命令行窗口才能生效在旧窗口里输入命令依然会提示“不是内部或外部命令”。这个坑坑过无数新手不是你的操作有问题是窗口没刷新。macOS和Linux用户就简单多了。macOS上如果你装了Homebrew直接一句brew install android-platform-tools就完事Linux上Ubuntu系用sudo apt install adbFedora系用sudo dnf install android-tools。这些包管理器装完直接全局可用不用配环境变量。还有一个容易忽略的点Windows上老机型可能还需要装手机厂商的USB驱动尤其是那些冷门品牌。Windows 10/11系统其实自带了很多通用ADB驱动但碰上识别不了的情况最好去手机官网的“服务支持”页面下载对应驱动别随便装那些第三方驱动管家之类的软件问题更多。1.3 手机端准备工作不开USB调试后面全是白搭电脑端的ADB工具装好了手机这边也得先做设置。核心就是打开“开发者选项”里的“USB调试”开关。这里有个反直觉的点Android系统默认隐藏了“开发者选项”入口你得先找到“关于手机”这一栏连续点击“版本号”7次系统才会提示“您已进入开发者模式”。不同品牌的手机入口位置各有差异但基本都在“设置-关于手机”这一层。打开之后再回到设置主目录就能看到“开发者选项”了。进入开发者选项后把“USB调试”开关打开有的手机还会让你确认一次要点允许。这里我建议同时把“USB调试安全设置”也打开这个选项允许你通过ADB授权模拟点击等操作后面做自动化脚本的时候会用到。不过部分手机默认隐藏这个选项需要插着数据线连着电脑才会出现。手机准备好之后用数据线连接电脑手机屏幕上通常会弹出一个“是否允许USB调试”的对话框勾选“始终允许”点确定。如果没弹窗那多半是驱动没装好或者数据线有问题。提示数据线尽量用原装线或者品牌线市面上很多“只能充电不能传数据”的劣质线会导致ADB设备列表死活认不出手机。这是新手排查问题的第一优先级很多人瞎折腾半天驱动结果换根线就好了。2. 新手必会的ADB基础命令照着抄就行2.1 设备连接与状态检查先确认手机有没有被电脑“看到”所有ADB操作的第一步都是确认设备是否成功连接。命令就一句adb devices它会列出当前所有连接到电脑的安卓设备。正常情况下的输出长这样List of devices attached R5CT12ABCDE device前面的序列号是设备编号后面的device表示设备已正常授权并连接。如果你看到的状态是offline说明设备连接不稳定可能是数据线问题、驱动问题也可能是手机和电脑之间的USB端口供电不稳换个插口试试。如果看到unauthorized那就是手机屏幕上没点“允许USB调试”的授权框重新拔插数据线再确认一次或者执行adb kill-server然后adb start-server重启ADB服务再试。还有个常见情况明明插了线但adb devices输出是空的。这时候先用adb kill-server杀掉后台ADB服务再adb start-server重启服务很多时候就能解决。如果还是不行检查设备管理器里有没有带黄色感叹号的设备有的话说明驱动没对上。设备连接确认没问题之后日常调试中还有几个高频命令值得现在就记住。adb shell是进入手机的命令行环境进入之后你就在安卓的Linux内核环境里操作了可以跑一些简单的shell指令adb get-state直接打印设备状态device、offline、unauthorized三种情况一目了然适合写脚本时做前置判断用。2.2 安装卸载应用、传文件这几个命令每天都要用连接好设备先试试最常用的安装命令adb install -r 包名.apk。把这个命令拆解一下-r参数表示允许覆盖安装也就是保留应用数据的情况下重新安装不加-r的话如果手机原本就装了这个应用会提示安装失败。如果还想保留应用数据和缓存用adb install -r -d 包名.apk这是针对版本号降低的情况强制降级安装。卸应用也有两种方式。想保留数据和缓存用adb uninstall -k 包名实测下来这个命令在某些定制系统上表现不稳不建议依赖它彻底的卸载就是adb uninstall 包名直接清除所有数据。注意这里要用的是应用的包名比如com.tencent.mm而不是应用显示名称。adb shell pm list packages | grep 关键词可以用来快速查某个应用的完整包名这个组合命令在管理应用时特别实用。文件传输方面adb push 本地路径 手机路径是从电脑往手机传文件比如adb push D:\test.apk /sdcard/Download/adb pull 手机路径 本地路径是从手机往电脑拉文件比如adb pull /sdcard/Download/test.apk D:\backup\。这两个命令日常用得非常频繁尤其是需要批量导出手机里的截图、录屏文件时比用微信传到电脑再保存省事得多。2.3 进入手机内部执行命令adb shell的常见用法adb shell进去之后你就拿到了一个安卓系统的Linux命令行。这个能力很强但新手容易在这块迷路所以我给你划几个最常用的重点。adb shell pm list packages这个命令可以列出手机上所有安装的包名配合grep过滤非常有效。比如你想找微信的包名adb shell pm list packages | grep tencent一下就能出来com.tencent.mm。这在用ADB管理应用比如卸载预装、冻结应用时是前置技能。adb shell dumpsys的命令家族也很重要。adb shell dumpsys package 包名能查看某个应用的所有信息包括版本号、权限列表、Activity列表adb shell dumpsys activity top能看当前前台界面的Activity做界面自动化排查问题的时候很管用adb shell dumpsys battery能看电池状态。这些dumpsys输出的信息量非常庞大新手看着会头晕但你不必全看懂只需要知道从里面能找到什么关键字段就行。另外adb shell screencap和adb shell screenrecord这两个命令要特别提一下它们分别负责截屏和录屏。截屏是adb shell screencap /sdcard/screen.png录屏是adb shell screenrecord /sdcard/demo.mp4。录屏默认最多录3分钟加--time-limit 10可以指定录10秒这个参数在给测试录bug复现过程时很实用。3. 进阶玩法日志抓取、自动化与系统设置调整3.1 adb logcat 抓日志排查崩溃问题的大杀器做安卓开发或者搞自动化测试的朋友adb logcat绝对是日常使用频率最高的ADB命令没有之一。它能把安卓系统运行时的日志实时输出到电脑屏幕应用崩溃、ANR、权限拒绝、网络请求失败各种异常都能从日志里找到线索。最简单的用法是adb logcat直接把所有日志刷在屏幕上但内容太多根本看不完。所以我给你一套我平时工作的标准操作流程。第一步清空旧日志让屏幕从干净状态开始抓取adb logcat -c。第二步复现你要抓的问题。第三步抓取日志并用管道过滤关键词adb logcat crash.log或者adb logcat -v time crash.log。加-v time会让每条日志带上时间戳排查问题先后顺序时非常有用。如果你只关心某个特定进程的日志可以用adb logcat --pid进程ID进程ID通过adb shell pidof 包名获取。想要更详细的系统级日志比如查看内核日志可以用adb shell dmesg不过这个一般只有在系统底层异常时才用得上。这里我要分享一个真实的排查经历。之前有个应用在特定机型上偶发崩溃用户反馈了一天都没定位到原因。后来我让反馈用户开着adb logcat -v time复现场景我远程看日志发现崩溃前有一条ActivityTaskManager的警告指出是某个Activity启动超时导致的ANR。顺着这条日志往前翻看到系统在启动那个Activity之前先去初始化了一个重型的SDK初始化过程卡了将近5秒才触发ANR。这就是典型的日志定位问题链路的案例没有logcat前面的警告日志光靠崩溃堆栈根本定位不到根因。3.2 用ADB调整屏幕刷新率、截图与录屏设备调试的实用技现在的安卓手机屏幕刷新率越做越高120Hz甚至144Hz都常见了。但有时候我们会遇到系统自动锁60Hz的情况或者游戏跑的刷新率不对。用ADB可以强制修改屏幕刷新率这条命令在不少折腾党之间流传很广adb shell settings put system peak_refresh_rate 120 adb shell settings put system min_refresh_rate 120这两句的意思是把系统的最高和最低刷新率都设为120Hz。peak_refresh_rate是最高刷新率min_refresh_rate是最低刷新率两者都设成同一个值系统就会被“固定”在对应的刷新率上。这里有个关键点如果你的屏幕硬件本身最高只有90Hz你设置成120Hz不仅没效果还可能导致屏幕闪烁甚至黑屏。改之前先用adb shell dumpsys display | grep refreshRate确认一下当前屏幕硬件支持的刷新率范围。类似地分辨率也可以用ADB调整。adb shell wm size 1080x2340可以直接修改屏幕分辨率adb shell wm density 440可以修改DPI屏幕密度。这俩命令在日常调试中偶尔会用上但改动后需要adb shell wm size reset和adb shell wm density reset恢复原样。注意修改分辨率之后桌面图标和App布局可能会乱系统的兼容性处理有时候也会出问题所以这两个操作仅限临时测试用不要长期改。说到ADB的另一个高频场景——生成测试报告或者做问题反馈时需要截图。前面提过adb shell screencap这里再补充一个更方便的变体adb exec-out screencap -p screen.png。区别在于exec-out方式直接输出二进制流到电脑端在Windows的CMD里用这个命令比adb shell screencap后再pull要少一步而且不会因为编码问题导致生成的文件无法打开。3.3 给App授予特殊权限无障碍、悬浮窗、联网控制用ADB管理应用权限是ADB最实用但也最需要小心的功能之一。这里重点讲几个高频用法。无障碍权限。很多自动化工具都需要无障碍权限但部分手机的系统设置里把这个权限藏得很深或者在设置界面直接搜不到。ADB可以直接授予adb shell appops set 包名 android:accessibility_access allow不过不同安卓版本对无障碍权限的管理方式有差异Android 11及以上部分机型可能不支持通过appops直接授予这时候只能引导用户去设置里手动开启。我这里必须提醒一句无障碍权限能模拟点击、读取屏幕内容是系统敏感权限只给你信任的应用开。网上那些“微信自动打卡”脚本原理就是通过ADB授予无障碍权限然后用脚本模拟屏幕点击操作但你得想清楚把自己设备的无障碍权限交出去的后果。悬浮窗权限。做录屏、画中画或悬浮球功能的应用需要这个权限ADB授权命令是adb shell appops set 包名 SYSTEM_ALERT_WINDOW allow禁止应用联网。有些预装应用或后台应用一直偷跑流量用ADB可以精确控制。常规做法是adb shell cmd appops set 包名 INTERNET deny不过这个命令在部分系统上有兼容问题实测不行的话可以试试用adb shell pm disable-user 包名把应用直接冻结或者用adb shell cmd appops set 包名 android:interact_across_profiles deny这种思路去限制。需要说明的是禁用某些应用可能导致系统功能异常尤其是系统应用操作前最好先确认这个应用的角色是什么。还有一个被问得特别多的场景vivo等品牌手机系统的精简列表。网上流传的各种“ADB精简列表”本质就是通过adb shell pm list packages找出预装应用包名再通过pm disable-user或pm uninstall把它们禁用或删除。我自己实测下来禁用系统级应用有风险轻则某个功能失效重则系统设置崩掉。所以这里强烈建议注意精简系统应用前先把包名记下来。一旦出现问题用adb shell pm enable 包名或adb shell pm install-existing 包名就能恢复。千万不要一次性禁用太多应用一次一个重启观察确认没问题再继续下一个。3.4 用ADB自动模拟操作能写脚本的都该学一点ADB能模拟点击、滑动、按键输入也就是说你可以用脚本控制手机完成一系列重复操作。这叫ADB自动化本质是向手机发送input事件。点击模拟是adb shell input tap 500 1200前一个参数是X坐标后一个是Y坐标单位是像素。滑动是adb shell input swipe 500 2000 500 500意思是手指从坐标(500,2000)滑到(500,500)。长按在部分系统上可以用adb shell input swipe x y x y 持续时间来实现因为长按本质就是一个原地滑动比如adb shell input swipe 500 1200 500 1200 2000就是长按2秒。文本输入是adb shell input text hello但只能输入英文和数字中文输入需要借助剪贴板操作相对麻烦实际用得不多。按键操作包括adb shell input keyevent 26电源键、adb shell input keyevent 4返回键、adb shell input keyevent 3Home键这几个最常用。写ADB自动化脚本时我建议用Python加subprocess来执行ADB命令比在Shell里写纯命令好维护得多。核心思路就是先adb shell wm size获取屏幕分辨率然后按比例计算坐标点这样不同机型上脚本的兼容性会好很多。比如点击屏幕中央代码就是adb shell input tap 屏幕宽度/2 屏幕高度/2。4. 常见问题排查与避坑经验速查表4.1 adb unauthorized、device offline、找不到设备三连问排查法“adb unauthorized怎么解决”这个关键词热度一直很高。遇到unauthorized说明手机和电脑的ADB配对授权还没有完成。最简单的方式是手机端打开“开发者选项”点“撤销USB调试授权”然后重新插拔数据线手机屏幕会再次弹出“是否允许USB调试”的框勾选“始终允许”问题就解决了。device offline比unauthorized更麻烦一些。它说明电脑曾经成功连接过手机但现在通讯中断了。可以先执行adb kill-server和adb start-server重启ADB服务然后重新插拔数据线。还不行就把手机端开发者选项里的“USB调试”关闭再打开一次强制重置连接状态。偶尔也有可能是电脑上有多个ADB版本冲突导致server状态混乱这种情况把电脑上所有跟ADB相关的进程都关掉重新执行adb start-server。找不到设备adb devices输出为空这种问题常见的解决顺序我梳理成一张表方便你照着查排查步骤具体操作解决概率检查数据线换一根确认能传数据的品牌线高检查USB模式手机连接电脑后下拉通知栏把USB模式从“仅充电”切到“文件传输(MTP)”高重启ADB服务执行adb kill-server后adb start-server中检查驱动打开设备管理器查看有无黄色感叹号设备有则安装厂商驱动中更换USB接口优先使用主机背面USB接口避免前置面板供电不稳定低4.2 模拟器和电视上的ADB端口、地址和特殊注意事项夜神模拟器在热搜词里出现了不少次这里专门说一下。模拟器里的ADB和真机有个关键区别模拟器不是通过USB连接电脑而是通过网络端口通讯。夜神模拟器的ADB端口默认是62001也可能因为版本不同而不同所以在连接之前先用adb connect 127.0.0.1:62001手动连接一下。有的模拟器需要你先在模拟器设置里打开“允许ADB连接”选项否则即使端口连上了也会被拒。创维等电视/盒子开启ADB是另一个常见的应用场景。老款创维电视开ADB的方法通常是进入“设置” → “系统” → “开发者选项”里打开“ADB调试”或者在某些型号上用遥控器按特定组合键呼出隐藏菜单。部分老款创维电视需要进入工厂菜单通常是在“关于本机”界面反复按“OK”键才能找到ADB开关。如果你找半天找不到直接在“设置”里搜索“ADB”部分新固件支持搜索直达。电视端ADB常用于安装第三方应用、抓取日志调试操作时建议用有线网络连接电视与电脑Wi-Fi连接偶尔会因为信号问题导致ADB断连。用ADB连接电视或盒子时不能用adb devices直接发现设备因为不是USB连接。你需要知道电视的IP地址然后adb connect 192.168.1.100:55555555是ADB网络调试的默认端口。连接成功后再执行adb devices应该能看到一个192.168.1.100:5555开头的设备。部分电视品牌出于安全考虑固件里默认没有开放ADB端口这就需要先用USB方式连接电视调试开启或者通过电视厂商的开发者模式入口开放。4.3 特殊场景ADB在系统精简、数据库备份、日志持久化里的坑“红米K70能用ADB冻结吗”这类搜索热度也很高。答案是能用小米系的MIUI/HyperOS对ADB的开放程度一直还可以。用adb shell pm disable-user --user 0 包名可以冻结应用这个命令的效果和设置里“禁用应用”一样比pm uninstall安全得多。示例如下adb shell pm disable-user --user 0 com.miui.notes要恢复的话就执行adb shell pm enable 包名。冻结应用有一个好处它不会删除应用数据恢复后什么都不用重新配置。而adb uninstall会把应用彻底卸载掉对于系统应用比如小米的某些系统组件pm uninstall可能直接报错这时候也只能用disable-user。有时候我们需要备份手机上某个应用的数据ADB提供了adb backup命令但说实话这个命令在Android 6.0之后用处越来越小很多应用禁止了通过ADB备份自己的数据。如果你确实需要备份某个应用的数据更靠谱的方式是用adb shell进去找到应用的数据目录一般在/data/data/包名/下然后run-as 包名进入应用私有目录拷贝出来但run-as要求应用是debuggable的普通正式版应用根本进不去。这个方向操作门槛比较高新手不建议强行折腾。日志持久化这块也有个常见的坑。用adb logcat log.txt抓日志时如果中途手机断开连接这个日志文件可能就没法继续写了而且之前抓到的部分也可能没有保存完全。所以更稳的做法是加上-d参数一次性把缓冲区里的日志倾倒出来adb logcat -d -v time log.txt这样即使设备断连也能拿到断开前缓冲区里的日志。不过实际排查问题时那种需要持续观察日志的场景还是得开着实时抓取所以adb logcat log.txt和adb logcat -d各有适用场景都记下来不吃亏。4.4 几个容易踩坑的ADB“冷知识”写这篇教程的最后一part我想把自己这几年用ADB踩过的小坑集中清点一下。第一条是关于命令执行路径的。adb install后面跟的APK路径在Windows上如果路径里有空格比如D:\My Games\test.apk命令会识别出错。正确的做法是用引号包住整个路径adb install D:\My Games\test.apk。第二条是adb push和adb pull的路径规则。在Windows上ADB的push和pull的本地路径可以用反斜杠或正斜杠但手机端路径一定是用正斜杠adb push C:\test.txt /sdcard/Download/没问题但如果你写成\sdcard\Download\会直接报错“remote object not found”。第三条是adb shell命令中特殊字符的转义问题。如果你在shell命令里使用了管道符|、重定向符、通配符*这些字符在Windows的CMD里它们会被Windows先解析一遍导致命令执行结果和预期完全不一样。解决办法是在需要这些字符时给整段shell命令加上引号或者在PowerShell里用反引号转义。第四条关于ADB环境变量。如果你手动配置环境变量时不小心把变量名拼错了比如ANDROID_HOME拼成ANDROID_HMOE那即使你安装了很多Android开发工具ADB也会提示找不到命令。配置完环境变量之后建议重启电脑再验证一次因为有些系统服务不会立即读取最新环境变量。第五条是关于“免Root使用ADB”的边界问题。很多人以为ADB能做的事是无限的这其实是误解。ADB的权限比Root低不少很多系统级修改比如修改/system分区、卸载系统核心组件直接执行会报permission denied。网上很多教程没说清楚这一点导致部分新手以为ADB能替代Root权限。事实是ADB能做的是在“允许调试”的权限框架内做大量操作但如果你要动的文件在系统只读分区必须有Root配合才能完成。我个人在实际操作中的体会是ADB是一座桥梁它不负责给你“无限权力”但它能让你以最高效的方式在合理范围内完成各种操作。用久了你会发现在命令行里敲adb shell进入手机的世界那种掌控感是许多GUI工具给不了的。这篇笔记是我自己从入门到上手的完整路径记录如果你照着做遇到问题的时候回来对照一下这里的排查清单我相信你能比当年的我少走很多弯路。
1. ADB到底是个啥以及装好它的正确姿势1.1 先搞明白ADB不是“一键刷机”那种黑科技很多刚接触安卓开发或者喜欢折腾手机的朋友第一次听到“ADB”都会觉得这玩意儿挺神秘。其实说白了ADBAndroid Debug Bridge就是安卓系统和电脑之间的一座调试桥梁它让你能在电脑的命令行窗口里直接向手机下发各种操作指令。不管是装应用、传文件、抓日志还是修改一些系统层级的设置只要手机开了USB调试模式ADB几乎都能帮你搞定。它为什么重要因为安卓系统本身就是一个半封闭的系统很多系统内部的接口和状态普通用户从手机屏幕上根本看不到也没法直接操作。ADB相当于给了你一把“后台管理钥匙”你可以像管理服务器一样去管理你的安卓设备。对开发者来说它是最基础的调试工具对喜欢折腾的玩家来说它也是实现各种“骚操作”的入口。新手刚开始接触ADB最容易犯的毛病是觉得它很难迟迟不敢动手。实际上你用熟了就能发现它来来去去就那么二三十个高频命令原理也不复杂。这篇文章就是把我自己从“看到命令行就头疼”到“用ADB解决各种实际问题”这段过程里的经验整理出来尤其是那些网上教程里很少讲到的细节和坑。1.2 环境配置Windows、macOS、Linux三种系统怎么装最快先说结论别卡在环境配置这一步它是整个ADB使用中门槛最低但最劝退新手的一环。配置方式各大系统有差异我给你拆开说。在Windows上最省心的办法是直接用“15 seconds ADB Installer”这种一键安装包。名字很直白15秒装完它会把ADB驱动和平台工具一起装好自动配好环境变量装完之后在任意目录打开命令行输入adb version能出来版本号就说明成功了。我自己给装系统的朋友推过很多次这个方案确实省事。如果你不想用第三方安装包那就手动配置。去安卓开发者官网下载Platform Tools压缩包解压到一个路径里比如D:\platform-tools然后右键“此电脑” → 属性 → 高级系统设置 → 环境变量在Path里新建一行把这个路径加进去。这里注意一个细节添加环境变量后必须新开一个命令行窗口才能生效在旧窗口里输入命令依然会提示“不是内部或外部命令”。这个坑坑过无数新手不是你的操作有问题是窗口没刷新。macOS和Linux用户就简单多了。macOS上如果你装了Homebrew直接一句brew install android-platform-tools就完事Linux上Ubuntu系用sudo apt install adbFedora系用sudo dnf install android-tools。这些包管理器装完直接全局可用不用配环境变量。还有一个容易忽略的点Windows上老机型可能还需要装手机厂商的USB驱动尤其是那些冷门品牌。Windows 10/11系统其实自带了很多通用ADB驱动但碰上识别不了的情况最好去手机官网的“服务支持”页面下载对应驱动别随便装那些第三方驱动管家之类的软件问题更多。1.3 手机端准备工作不开USB调试后面全是白搭电脑端的ADB工具装好了手机这边也得先做设置。核心就是打开“开发者选项”里的“USB调试”开关。这里有个反直觉的点Android系统默认隐藏了“开发者选项”入口你得先找到“关于手机”这一栏连续点击“版本号”7次系统才会提示“您已进入开发者模式”。不同品牌的手机入口位置各有差异但基本都在“设置-关于手机”这一层。打开之后再回到设置主目录就能看到“开发者选项”了。进入开发者选项后把“USB调试”开关打开有的手机还会让你确认一次要点允许。这里我建议同时把“USB调试安全设置”也打开这个选项允许你通过ADB授权模拟点击等操作后面做自动化脚本的时候会用到。不过部分手机默认隐藏这个选项需要插着数据线连着电脑才会出现。手机准备好之后用数据线连接电脑手机屏幕上通常会弹出一个“是否允许USB调试”的对话框勾选“始终允许”点确定。如果没弹窗那多半是驱动没装好或者数据线有问题。提示数据线尽量用原装线或者品牌线市面上很多“只能充电不能传数据”的劣质线会导致ADB设备列表死活认不出手机。这是新手排查问题的第一优先级很多人瞎折腾半天驱动结果换根线就好了。2. 新手必会的ADB基础命令照着抄就行2.1 设备连接与状态检查先确认手机有没有被电脑“看到”所有ADB操作的第一步都是确认设备是否成功连接。命令就一句adb devices它会列出当前所有连接到电脑的安卓设备。正常情况下的输出长这样List of devices attached R5CT12ABCDE device前面的序列号是设备编号后面的device表示设备已正常授权并连接。如果你看到的状态是offline说明设备连接不稳定可能是数据线问题、驱动问题也可能是手机和电脑之间的USB端口供电不稳换个插口试试。如果看到unauthorized那就是手机屏幕上没点“允许USB调试”的授权框重新拔插数据线再确认一次或者执行adb kill-server然后adb start-server重启ADB服务再试。还有个常见情况明明插了线但adb devices输出是空的。这时候先用adb kill-server杀掉后台ADB服务再adb start-server重启服务很多时候就能解决。如果还是不行检查设备管理器里有没有带黄色感叹号的设备有的话说明驱动没对上。设备连接确认没问题之后日常调试中还有几个高频命令值得现在就记住。adb shell是进入手机的命令行环境进入之后你就在安卓的Linux内核环境里操作了可以跑一些简单的shell指令adb get-state直接打印设备状态device、offline、unauthorized三种情况一目了然适合写脚本时做前置判断用。2.2 安装卸载应用、传文件这几个命令每天都要用连接好设备先试试最常用的安装命令adb install -r 包名.apk。把这个命令拆解一下-r参数表示允许覆盖安装也就是保留应用数据的情况下重新安装不加-r的话如果手机原本就装了这个应用会提示安装失败。如果还想保留应用数据和缓存用adb install -r -d 包名.apk这是针对版本号降低的情况强制降级安装。卸应用也有两种方式。想保留数据和缓存用adb uninstall -k 包名实测下来这个命令在某些定制系统上表现不稳不建议依赖它彻底的卸载就是adb uninstall 包名直接清除所有数据。注意这里要用的是应用的包名比如com.tencent.mm而不是应用显示名称。adb shell pm list packages | grep 关键词可以用来快速查某个应用的完整包名这个组合命令在管理应用时特别实用。文件传输方面adb push 本地路径 手机路径是从电脑往手机传文件比如adb push D:\test.apk /sdcard/Download/adb pull 手机路径 本地路径是从手机往电脑拉文件比如adb pull /sdcard/Download/test.apk D:\backup\。这两个命令日常用得非常频繁尤其是需要批量导出手机里的截图、录屏文件时比用微信传到电脑再保存省事得多。2.3 进入手机内部执行命令adb shell的常见用法adb shell进去之后你就拿到了一个安卓系统的Linux命令行。这个能力很强但新手容易在这块迷路所以我给你划几个最常用的重点。adb shell pm list packages这个命令可以列出手机上所有安装的包名配合grep过滤非常有效。比如你想找微信的包名adb shell pm list packages | grep tencent一下就能出来com.tencent.mm。这在用ADB管理应用比如卸载预装、冻结应用时是前置技能。adb shell dumpsys的命令家族也很重要。adb shell dumpsys package 包名能查看某个应用的所有信息包括版本号、权限列表、Activity列表adb shell dumpsys activity top能看当前前台界面的Activity做界面自动化排查问题的时候很管用adb shell dumpsys battery能看电池状态。这些dumpsys输出的信息量非常庞大新手看着会头晕但你不必全看懂只需要知道从里面能找到什么关键字段就行。另外adb shell screencap和adb shell screenrecord这两个命令要特别提一下它们分别负责截屏和录屏。截屏是adb shell screencap /sdcard/screen.png录屏是adb shell screenrecord /sdcard/demo.mp4。录屏默认最多录3分钟加--time-limit 10可以指定录10秒这个参数在给测试录bug复现过程时很实用。3. 进阶玩法日志抓取、自动化与系统设置调整3.1 adb logcat 抓日志排查崩溃问题的大杀器做安卓开发或者搞自动化测试的朋友adb logcat绝对是日常使用频率最高的ADB命令没有之一。它能把安卓系统运行时的日志实时输出到电脑屏幕应用崩溃、ANR、权限拒绝、网络请求失败各种异常都能从日志里找到线索。最简单的用法是adb logcat直接把所有日志刷在屏幕上但内容太多根本看不完。所以我给你一套我平时工作的标准操作流程。第一步清空旧日志让屏幕从干净状态开始抓取adb logcat -c。第二步复现你要抓的问题。第三步抓取日志并用管道过滤关键词adb logcat crash.log或者adb logcat -v time crash.log。加-v time会让每条日志带上时间戳排查问题先后顺序时非常有用。如果你只关心某个特定进程的日志可以用adb logcat --pid进程ID进程ID通过adb shell pidof 包名获取。想要更详细的系统级日志比如查看内核日志可以用adb shell dmesg不过这个一般只有在系统底层异常时才用得上。这里我要分享一个真实的排查经历。之前有个应用在特定机型上偶发崩溃用户反馈了一天都没定位到原因。后来我让反馈用户开着adb logcat -v time复现场景我远程看日志发现崩溃前有一条ActivityTaskManager的警告指出是某个Activity启动超时导致的ANR。顺着这条日志往前翻看到系统在启动那个Activity之前先去初始化了一个重型的SDK初始化过程卡了将近5秒才触发ANR。这就是典型的日志定位问题链路的案例没有logcat前面的警告日志光靠崩溃堆栈根本定位不到根因。3.2 用ADB调整屏幕刷新率、截图与录屏设备调试的实用技现在的安卓手机屏幕刷新率越做越高120Hz甚至144Hz都常见了。但有时候我们会遇到系统自动锁60Hz的情况或者游戏跑的刷新率不对。用ADB可以强制修改屏幕刷新率这条命令在不少折腾党之间流传很广adb shell settings put system peak_refresh_rate 120 adb shell settings put system min_refresh_rate 120这两句的意思是把系统的最高和最低刷新率都设为120Hz。peak_refresh_rate是最高刷新率min_refresh_rate是最低刷新率两者都设成同一个值系统就会被“固定”在对应的刷新率上。这里有个关键点如果你的屏幕硬件本身最高只有90Hz你设置成120Hz不仅没效果还可能导致屏幕闪烁甚至黑屏。改之前先用adb shell dumpsys display | grep refreshRate确认一下当前屏幕硬件支持的刷新率范围。类似地分辨率也可以用ADB调整。adb shell wm size 1080x2340可以直接修改屏幕分辨率adb shell wm density 440可以修改DPI屏幕密度。这俩命令在日常调试中偶尔会用上但改动后需要adb shell wm size reset和adb shell wm density reset恢复原样。注意修改分辨率之后桌面图标和App布局可能会乱系统的兼容性处理有时候也会出问题所以这两个操作仅限临时测试用不要长期改。说到ADB的另一个高频场景——生成测试报告或者做问题反馈时需要截图。前面提过adb shell screencap这里再补充一个更方便的变体adb exec-out screencap -p screen.png。区别在于exec-out方式直接输出二进制流到电脑端在Windows的CMD里用这个命令比adb shell screencap后再pull要少一步而且不会因为编码问题导致生成的文件无法打开。3.3 给App授予特殊权限无障碍、悬浮窗、联网控制用ADB管理应用权限是ADB最实用但也最需要小心的功能之一。这里重点讲几个高频用法。无障碍权限。很多自动化工具都需要无障碍权限但部分手机的系统设置里把这个权限藏得很深或者在设置界面直接搜不到。ADB可以直接授予adb shell appops set 包名 android:accessibility_access allow不过不同安卓版本对无障碍权限的管理方式有差异Android 11及以上部分机型可能不支持通过appops直接授予这时候只能引导用户去设置里手动开启。我这里必须提醒一句无障碍权限能模拟点击、读取屏幕内容是系统敏感权限只给你信任的应用开。网上那些“微信自动打卡”脚本原理就是通过ADB授予无障碍权限然后用脚本模拟屏幕点击操作但你得想清楚把自己设备的无障碍权限交出去的后果。悬浮窗权限。做录屏、画中画或悬浮球功能的应用需要这个权限ADB授权命令是adb shell appops set 包名 SYSTEM_ALERT_WINDOW allow禁止应用联网。有些预装应用或后台应用一直偷跑流量用ADB可以精确控制。常规做法是adb shell cmd appops set 包名 INTERNET deny不过这个命令在部分系统上有兼容问题实测不行的话可以试试用adb shell pm disable-user 包名把应用直接冻结或者用adb shell cmd appops set 包名 android:interact_across_profiles deny这种思路去限制。需要说明的是禁用某些应用可能导致系统功能异常尤其是系统应用操作前最好先确认这个应用的角色是什么。还有一个被问得特别多的场景vivo等品牌手机系统的精简列表。网上流传的各种“ADB精简列表”本质就是通过adb shell pm list packages找出预装应用包名再通过pm disable-user或pm uninstall把它们禁用或删除。我自己实测下来禁用系统级应用有风险轻则某个功能失效重则系统设置崩掉。所以这里强烈建议注意精简系统应用前先把包名记下来。一旦出现问题用adb shell pm enable 包名或adb shell pm install-existing 包名就能恢复。千万不要一次性禁用太多应用一次一个重启观察确认没问题再继续下一个。3.4 用ADB自动模拟操作能写脚本的都该学一点ADB能模拟点击、滑动、按键输入也就是说你可以用脚本控制手机完成一系列重复操作。这叫ADB自动化本质是向手机发送input事件。点击模拟是adb shell input tap 500 1200前一个参数是X坐标后一个是Y坐标单位是像素。滑动是adb shell input swipe 500 2000 500 500意思是手指从坐标(500,2000)滑到(500,500)。长按在部分系统上可以用adb shell input swipe x y x y 持续时间来实现因为长按本质就是一个原地滑动比如adb shell input swipe 500 1200 500 1200 2000就是长按2秒。文本输入是adb shell input text hello但只能输入英文和数字中文输入需要借助剪贴板操作相对麻烦实际用得不多。按键操作包括adb shell input keyevent 26电源键、adb shell input keyevent 4返回键、adb shell input keyevent 3Home键这几个最常用。写ADB自动化脚本时我建议用Python加subprocess来执行ADB命令比在Shell里写纯命令好维护得多。核心思路就是先adb shell wm size获取屏幕分辨率然后按比例计算坐标点这样不同机型上脚本的兼容性会好很多。比如点击屏幕中央代码就是adb shell input tap 屏幕宽度/2 屏幕高度/2。4. 常见问题排查与避坑经验速查表4.1 adb unauthorized、device offline、找不到设备三连问排查法“adb unauthorized怎么解决”这个关键词热度一直很高。遇到unauthorized说明手机和电脑的ADB配对授权还没有完成。最简单的方式是手机端打开“开发者选项”点“撤销USB调试授权”然后重新插拔数据线手机屏幕会再次弹出“是否允许USB调试”的框勾选“始终允许”问题就解决了。device offline比unauthorized更麻烦一些。它说明电脑曾经成功连接过手机但现在通讯中断了。可以先执行adb kill-server和adb start-server重启ADB服务然后重新插拔数据线。还不行就把手机端开发者选项里的“USB调试”关闭再打开一次强制重置连接状态。偶尔也有可能是电脑上有多个ADB版本冲突导致server状态混乱这种情况把电脑上所有跟ADB相关的进程都关掉重新执行adb start-server。找不到设备adb devices输出为空这种问题常见的解决顺序我梳理成一张表方便你照着查排查步骤具体操作解决概率检查数据线换一根确认能传数据的品牌线高检查USB模式手机连接电脑后下拉通知栏把USB模式从“仅充电”切到“文件传输(MTP)”高重启ADB服务执行adb kill-server后adb start-server中检查驱动打开设备管理器查看有无黄色感叹号设备有则安装厂商驱动中更换USB接口优先使用主机背面USB接口避免前置面板供电不稳定低4.2 模拟器和电视上的ADB端口、地址和特殊注意事项夜神模拟器在热搜词里出现了不少次这里专门说一下。模拟器里的ADB和真机有个关键区别模拟器不是通过USB连接电脑而是通过网络端口通讯。夜神模拟器的ADB端口默认是62001也可能因为版本不同而不同所以在连接之前先用adb connect 127.0.0.1:62001手动连接一下。有的模拟器需要你先在模拟器设置里打开“允许ADB连接”选项否则即使端口连上了也会被拒。创维等电视/盒子开启ADB是另一个常见的应用场景。老款创维电视开ADB的方法通常是进入“设置” → “系统” → “开发者选项”里打开“ADB调试”或者在某些型号上用遥控器按特定组合键呼出隐藏菜单。部分老款创维电视需要进入工厂菜单通常是在“关于本机”界面反复按“OK”键才能找到ADB开关。如果你找半天找不到直接在“设置”里搜索“ADB”部分新固件支持搜索直达。电视端ADB常用于安装第三方应用、抓取日志调试操作时建议用有线网络连接电视与电脑Wi-Fi连接偶尔会因为信号问题导致ADB断连。用ADB连接电视或盒子时不能用adb devices直接发现设备因为不是USB连接。你需要知道电视的IP地址然后adb connect 192.168.1.100:55555555是ADB网络调试的默认端口。连接成功后再执行adb devices应该能看到一个192.168.1.100:5555开头的设备。部分电视品牌出于安全考虑固件里默认没有开放ADB端口这就需要先用USB方式连接电视调试开启或者通过电视厂商的开发者模式入口开放。4.3 特殊场景ADB在系统精简、数据库备份、日志持久化里的坑“红米K70能用ADB冻结吗”这类搜索热度也很高。答案是能用小米系的MIUI/HyperOS对ADB的开放程度一直还可以。用adb shell pm disable-user --user 0 包名可以冻结应用这个命令的效果和设置里“禁用应用”一样比pm uninstall安全得多。示例如下adb shell pm disable-user --user 0 com.miui.notes要恢复的话就执行adb shell pm enable 包名。冻结应用有一个好处它不会删除应用数据恢复后什么都不用重新配置。而adb uninstall会把应用彻底卸载掉对于系统应用比如小米的某些系统组件pm uninstall可能直接报错这时候也只能用disable-user。有时候我们需要备份手机上某个应用的数据ADB提供了adb backup命令但说实话这个命令在Android 6.0之后用处越来越小很多应用禁止了通过ADB备份自己的数据。如果你确实需要备份某个应用的数据更靠谱的方式是用adb shell进去找到应用的数据目录一般在/data/data/包名/下然后run-as 包名进入应用私有目录拷贝出来但run-as要求应用是debuggable的普通正式版应用根本进不去。这个方向操作门槛比较高新手不建议强行折腾。日志持久化这块也有个常见的坑。用adb logcat log.txt抓日志时如果中途手机断开连接这个日志文件可能就没法继续写了而且之前抓到的部分也可能没有保存完全。所以更稳的做法是加上-d参数一次性把缓冲区里的日志倾倒出来adb logcat -d -v time log.txt这样即使设备断连也能拿到断开前缓冲区里的日志。不过实际排查问题时那种需要持续观察日志的场景还是得开着实时抓取所以adb logcat log.txt和adb logcat -d各有适用场景都记下来不吃亏。4.4 几个容易踩坑的ADB“冷知识”写这篇教程的最后一part我想把自己这几年用ADB踩过的小坑集中清点一下。第一条是关于命令执行路径的。adb install后面跟的APK路径在Windows上如果路径里有空格比如D:\My Games\test.apk命令会识别出错。正确的做法是用引号包住整个路径adb install D:\My Games\test.apk。第二条是adb push和adb pull的路径规则。在Windows上ADB的push和pull的本地路径可以用反斜杠或正斜杠但手机端路径一定是用正斜杠adb push C:\test.txt /sdcard/Download/没问题但如果你写成\sdcard\Download\会直接报错“remote object not found”。第三条是adb shell命令中特殊字符的转义问题。如果你在shell命令里使用了管道符|、重定向符、通配符*这些字符在Windows的CMD里它们会被Windows先解析一遍导致命令执行结果和预期完全不一样。解决办法是在需要这些字符时给整段shell命令加上引号或者在PowerShell里用反引号转义。第四条关于ADB环境变量。如果你手动配置环境变量时不小心把变量名拼错了比如ANDROID_HOME拼成ANDROID_HMOE那即使你安装了很多Android开发工具ADB也会提示找不到命令。配置完环境变量之后建议重启电脑再验证一次因为有些系统服务不会立即读取最新环境变量。第五条是关于“免Root使用ADB”的边界问题。很多人以为ADB能做的事是无限的这其实是误解。ADB的权限比Root低不少很多系统级修改比如修改/system分区、卸载系统核心组件直接执行会报permission denied。网上很多教程没说清楚这一点导致部分新手以为ADB能替代Root权限。事实是ADB能做的是在“允许调试”的权限框架内做大量操作但如果你要动的文件在系统只读分区必须有Root配合才能完成。我个人在实际操作中的体会是ADB是一座桥梁它不负责给你“无限权力”但它能让你以最高效的方式在合理范围内完成各种操作。用久了你会发现在命令行里敲adb shell进入手机的世界那种掌控感是许多GUI工具给不了的。这篇笔记是我自己从入门到上手的完整路径记录如果你照着做遇到问题的时候回来对照一下这里的排查清单我相信你能比当年的我少走很多弯路。
