1. 先理解ADB的底层逻辑它到底是一条什么桥如果你只是想在电脑上敲几条命令控制手机那确实不用先把ADB的源码翻一遍。但现实是我见过太多新手卡在同一个小地方照着教程输入 adb devices结果设备列表是空的或者前面顶着一个 unauthorized然后开始怀疑人生。这些问题的根子几乎都出在没搞懂ADB的基本工作方式上。ADB全称Android Debug Bridge官方定位是调试桥。桥意味着它连接两岸一头是你的电脑另一头是安卓设备。先把这个框架装进脑子里你才知道为什么有些命令必须加 adb shell为什么插上手机没反应要先查驱动为什么服务器偶尔抽风需要重启。这篇笔记就按我自己的学习路径来写先讲原理再搭环境然后按需求过命令最后把日志抓取和常见异常一次说清楚。1.1 三端架构Client、Server、adbd怎么分工ADB由三部分组成Client、Server、adbd。Client就是你电脑上敲的 adb 命令本身负责把指令打包Server是电脑后台常驻的一个服务进程默认监听本机5037端口负责发现设备、维护设备列表、转发指令adbd则是运行在安卓设备上的守护进程手机开启USB调试后由系统启动接收Server传来的命令并在设备上执行。用生活化的比喻Client是前台客服Server是调度中心adbd是执行任务的办事员。你在前台说需求前台转给调度中心调度中心分配到具体办事员办事员办完再把结果原路返回。这里有个新手容易忽略的点为什么不直接连设备非要经过Server这一层因为设备可能通过USB、网络、模拟器等多种通道接入Server统一管理这些连接还允许多个Client共享同一个服务进程。理解了这层你就明白为什么很多教程强调保持Server干净也就能理解后面要说的 adb kill-server 为什么能解决一堆玄学问题。1.2 为什么命令不好使时总让你先kill-server几乎所有ADB疑难杂症的通用开场白都是 adb kill-server 然后 adb start-server。核心原因是Server是常驻后台进程它内部缓存着设备状态。当手机休眠、USB线被快速拔插、电脑上同时装了多个手机助手时Server里的状态可能已经过时导致设备一直显示 offline或者指令发出去了没有响应。kill-server 等于把整个调度中心推倒重建所有设备重新被发现、重新握手80%的连接类问题在这一步就能解决。这个操作代价极低、速度极快所以遇到任何异常都值得先执行一轮重启ADB服务再往下排查。1.3 新手学ADB前先想清楚要用它干什么ADB的学习路径因人而异。开发者需要它来安装调试包、抓崩溃日志、做自动化测试玩机用户需要它来冻结预装应用、修改系统设置、清理厂商全家桶还有一批人是为了给智能电视或电视盒子安装第三方软件、精简开机广告。目标不同需要的命令清单完全不同。我的建议是别贪多先明确一个具体需求。比如把某个预装应用冻掉就学 pm disable-user 相关几条命令想抓个闪退日志就学 logcat 的过滤。带着问题去查、去用用一次记一次比从头到尾背命令有效得多。下面我就按搭建环境→常用命令→日志抓取→进阶操作→异常排查的顺序把各个场景串起来讲。2. 环境搭建驱动、工具包、开发者选项一步都别省2.1 选择工具包官方Platform Tools还是15秒安装器ADB不是手机上的应用而是电脑上的一组命令行工具。最推荐的来源是Android开发者官网的Platform Tools解压出来就包含 adb.exe、fastboot.exe 等文件Windows、macOS、Linux都有对应版本。国内用户如果官网下载不方便也可以通过Android Studio自带的SDK Manager拉取或者找正规大厂的镜像站。解压之后有两种用法一是每次都在解压目录里打开命令行操作能用但麻烦二是把目录路径加入系统环境变量PATH这样在任意路径下都能直接敲 adb 命令。我强烈建议用第二种一次配置长期受益。对Windows用户来说如果不想手动配环境变量可以考虑15 seconds ADB Installer这类一键安装器。它会自动把Platform Tools装到系统目录、配置好PATH还附带驱动安装选项比较适合不爱碰系统设置的朋友。不过这属于民间打包下载时注意来源安装时留个心眼别被捆绑软件顺带装进电脑。2.2 驱动安装的两个经典坑Windows下连接安卓设备第一个坎就是驱动。坑一设备管理器里能看到一个带黄色感叹号的设备显示为Android或ADB Interface说明驱动没正确安装。解决办法是右键更新驱动程序手动指定到Google USB Driver或对应厂商驱动的解压目录。网上搜机型USB驱动能找到各大厂商的官方驱动包三星、小米、华为这些都有专门页面。坑二电脑上装了各种手机助手、刷机工具、模拟器它们自带的ADB驱动版本很杂可能互相覆盖。具体表现是手机一插上系统托盘弹出助手通知然后 adb devices 里设备秒变offline。所以正式使用ADB前把同类工具退出最好卸载掉不需要的只保留你真正要用的那套平台工具。2.3 手机端准备开发者模式、USB调试和授权弹窗手机端准备工作就两步。第一步打开开发者选项标准路线是设置-关于手机-连续点击版本号7次不同厂商入口位置有差别但思路一样。第二步进入开发者选项打开USB调试。部分机型还有USB安装USB调试安全设置这类子开关建议一并打开。用数据线连接电脑后手机屏幕会弹出是否允许USB调试的对话框同时显示一串RSA指纹。这时候要在手机上勾选始终允许再点允许。很多人就是栽在这里电脑上 adb devices 显示 unauthorized其实是手机上的弹窗没点或者之前手滑点了不允许。这是新手阶段最高频的异常后面的排查章节我会展开讲。2.4 无线连接Android 11配对码和传统tcpip方式ADB不一定要用数据线。手机和电脑在同一个局域网内时可以走无线调试。Android 11及以上系统在开发者选项里提供了无线调试开关开启后选择使用配对码配对设备电脑上执行 adb pair 手机IP:配对端口输入屏幕上的配对码完成配对后再执行 adb connect 手机IP:调试端口 即可连接。老版本系统则需要先在USB连接状态下执行 adb tcpip 5555让设备的5555端口开始监听然后拔掉数据线执行 adb connect 手机IP:5555。无线调试连不上的常见原因有三个电脑和手机不在同一网段、路由器开了AP隔离、系统防火墙拦截了5037或5555端口。遇到连不上按这三个方向查大概率能解决。3. 新手高频命令实战按需求分组记比死背强多了3.1 设备状态三连devices、get-state、version一切操作开始前先用 adb devices 确认设备在线。这个命令列出当前连接的所有设备正常状态是 device如果显示 unauthorized 是授权问题显示 offline 是连接异常。adb devices -l 能看更多信息比如设备型号和传输方式。adb get-state 返回设备状态adb version 查看当前ADB版本。这里有个多设备场景容易被忽略电脑同时连着手机和模拟器时devices 列表会全部显示操作命令默认发给唯一设备如果有多个设备就必须用 adb -s 设备序列号 指定对象否则命令会直接报错。序列号在 adb devices 输出的第一列先看清楚再操作。3.2 应用管理安装、卸载、冻结、恢复应用相关命令是日常使用频率最高的一组我按用途拆开说。安装应用adb install app.apk加-r表示覆盖安装并保留数据加-d允许降级安装加-t允许安装测试包。日常最常用的是adb install -r。卸载应用adb uninstall 包名卸载普通第三方应用。如果是系统应用可以用adb shell pm uninstall --user 0 包名实现当前用户卸载效果等同于隐藏并移除恢复时用adb shell pm install-existing 包名。查看应用列表adb shell pm list packages -3列出所有第三方应用不加-3就列出全部后面可以接grep过滤关键字。冻结应用adb shell pm disable-user --user 0 包名冻结后应用图标消失、无法运行恢复用adb shell pm enable 包名。冻结比卸载安全因为它不修改系统分区出问题随时能恢复。经验提醒冻结系统应用之前先搜索确认包名对应什么功能。冻结桌面、设置、输入法、系统UI这类核心组件很可能直接导致桌面崩溃或者设置打不开。我自己的习惯是每冻结一个包就立刻看看桌面和设置是否正常确认无误再继续下一个不批量操作。3.3 截图录屏与文件互传截屏最稳妥的姿势是两条命令adb shell screencap -p /sdcard/screen.png先在手机上生成图片再adb pull /sdcard/screen.png拉回电脑也可以用连起来一次执行。之所以不推荐直接写adb exec-out screencap -p screen.png是因为Windows的PowerShell里重定向符默认按文本处理二进制数据保存下来的PNG文件往往损坏打不开。Linux和macOS终端下exec-out方式没问题Windows用户老老实实先存手机再pull。录屏对应adb shell screenrecord /sdcard/video.mp4在电脑终端按CtrlC停止。默认时长上限180秒可以用--time-limit限制时间、--size限制分辨率、--bit-rate控制码率。文件互传反向操作是adb push 本地文件 手机路径比如adb push test.apk /sdcard/。传大文件其实还是MTP模式直接拖拽更快ADB更适合传少量配置和小文件。3.4 模拟点击和文字输入含ADB键盘adb shell input系列命令是自动化爱好者的心头好。adb shell input tap x y模拟点击屏幕坐标adb shell input swipe x1 y1 x2 y2模拟滑动后面加一个数字可以控制滑动时长。adb shell input keyevent每个数字对应一个按键我列几个常用的键值功能3主页4返回187多任务66回车24 / 25音量加 / 音量减26电源键输入文字用adb shell input text hello但要注意它默认只支持ASCII字符中文和特殊符号常常失败空格要用%s代替。为了解决中文输入问题社区里流传着一个叫ADB键盘的输入法应用安装后启用并切换为当前输入法再执行 input text 命令内容会通过该输入法送达文本框中文英文都能输入。切换命令是adb shell ime enable 包名/服务名和adb shell ime set 包名/服务名先用adb shell ime list -s看看系统里有哪些输入法。这套模拟能力常被用来做定时任务、无障碍辅助之类的自动化比如有人拿它实现企业微信自动打卡。我得提醒一句任何自动化操作前先确认不违反公司制度、不涉及数据造假合规使用才是正路。4. adb logcat抓日志一坨输出里怎么捞有效信息4.1 输出格式与优先级过滤logcat是安卓系统的日志系统ADB可以把设备上的日志实时输出到电脑终端。别以为日志只有开发者才用应用闪退、后台异常、系统卡顿日志都是第一手证据。裸敲adb logcat输出量巨大所以必须学会过滤。每条日志包含日期时间、PID、TID、优先级、标签、消息内容。优先级从低到高依次是 V、D、I、W、E、F、S对应Verbose、Debug、Info、Warn、Error、Fatal、Silent。过滤表达式用标签:优先级的格式adb logcat *:E表示只看Error及以上adb logcat ActivityManager:I *:S表示只看ActivityManager标签的Info及以上其他全部静默。优先级含义V详细最啰嗦D调试I信息W警告E错误F致命S静默4.2 按应用包名/PID精确过滤定位某个应用的日志最有效的办法是先拿到应用进程号再按PID过滤。命令组合是adb shell pidof 包名获取PID然后adb logcat --pid该PID输出里就只剩这个应用进程的日志。新版ADB都支持--pid老版本不支持时可以用adb logcat | grep 包名代替虽然会有遗漏但多数场景够用。还有一个实用参数是-b。logcat日志按缓冲区划分main是应用主日志system是系统日志crash是崩溃日志events是事件日志。平时我们看的是main但应用崩溃时crash缓冲区的信息往往更直接。命令是adb logcat -b crash -d。加-d是dump模式把当前缓冲区内容打印完立即退出不会一直挂在那里刷屏。4.3 复现问题时的标准日志抓取流程正确抓日志的姿势不是问题发生了才开跑而是先清空再复现最后落盘。具体流程先执行adb logcat -c清空日志缓冲区然后正常复现问题最后adb logcat -d log.txt把全部日志保存下来。这样log.txt里的内容就是问题发生前后的完整上下文分析价值最高。日志文件通常很大拿到后先用关键词搜索比如报错信息里的核心词、应用包名、崩溃类名逐层缩小范围。Windows下看大文本文件别用记事本几MB的文件会卡到你怀疑人生建议用支持大文件搜索的文本工具。另一个经验是部分厂商ROM对logcat做了限制或过滤如果发现日志不完整检查开发者选项里有没有日志记录器缓冲区大小之类的选项调大缓冲区再试。5. 进阶玩法权限授予、刷新率调整、禁止联网与精简系统5.1 不root授权pm grant与appops的妙用很多应用要求的权限不需要root通过ADB就能授予核心是两个机制pm grant用于授予危险权限appops用于修改应用操作开关。比如给应用授予悬浮窗权限执行adb shell appops set 包名 SYSTEM_ALERT_WINDOW allow授权无障碍权限要用adb shell settings put secure enabled_accessibility_services 包名/服务组件名再加上adb shell settings put secure accessibility_enabled 1。这些操作对自动化测试和辅助功能开发很有用很多跳过开屏广告类工具背后就是这套思路。提醒一下settings put 修改的是系统配置操作前最好先adb shell settings get看一下当前值动手前记下原值方便回滚。改错了别慌把原值写回去就行。5.2 屏幕刷新率、分辨率、DPI的修改和还原现在的手机普遍是高刷屏但部分机型默认不给满血刷新率。用ADB可以强制修改adb shell settings put system peak_refresh_rate 120和adb shell settings put system min_refresh_rate 120两条都设成120系统就会倾向于以120Hz运行。查看当前值用adb shell settings get system peak_refresh_rate。不同机型字段可能不同有的在global表里有的叫refresh_rate可以先get相关字段看看。改分辨率用adb shell wm size 1080x1920改DPI用adb shell wm density 420改完立即生效。恢复用adb shell wm size reset和adb shell wm density reset。分辨率改小可以省电、降低渲染压力但图标布局会变部分应用可能显示异常DPI改小则让界面显示更多内容、看起来更精致。这类修改属于系统级设置如果改完屏幕显示异常别慌用reset命令恢复即可。前提是你记得命令所以我建议把这类常用命令提前存成脚本文件。5.3 禁止应用联网的操作和版本差异后台偷偷联网、频繁弹广告、上传数据这类问题很多人装第三方防火墙但其实有个不用root的办法adb shell appops set 包名 INTERNET deny。AppOps是安卓的应用操作权限框架INTERNET开关对应网络访问能力设为deny后该应用无法联网。注意两点第一这个命令在Android 10及以上系统上效果明显部分老版本或厂商定制UI不生效第二恢复联网用adb shell appops set 包名 INTERNET allow。我实测过某些国产机型上应用走系统通道时appops拦不住这时候要么root后配合防火墙要么就接受现实。禁网前先想清楚目的为了去广告、防止后台上传、还是避免应用联网校验目的明确再动手。5.4 vivo、小米等机型的安全精简思路网上经常看到vivo adb精简列表红米k70能冻结吗这类帖子本质上是教人用pm disable-user --user 0批量冻结厂商预装应用。这类列表可以参考但不要照抄因为同品牌不同型号、不同系统版本包名和依赖关系差异很大。我的做法是先导出自己机器上的包名列表adb shell pm list packages逐个搜索确认功能再决定是否冻结。优先冻结的通常是游戏中心、应用商店推荐位、广告服务、浏览器、视频音乐等无关应用。但凡名称里带launcher、systemui、settings、input、telephony、packageinstaller的组件一律不碰。精简系统的原则是最小干预能不动的就不动宁可保留广告也不冒着弄崩系统的风险乱删。冻结后先用几天观察稳定性某个功能异常了用adb shell pm enable 包名解除冻结即可。在你确实清楚后果之前永远选择冻结而不是卸载。6. 连接异常排查unauthorized、offline、模拟器和电视6.1 unauthorized的成因与两条解决路径这是新手提问区第一名。现象是 adb devices 输出设备名后面跟着 unauthorized。原因只有一个手机没有确认电脑的RSA指纹授权。首次连接时手机应该弹出允许USB调试对话框很多人没注意到或者系统弹窗被拦截了也可能是之前选过不允许授权被记录为拒绝。解决办法分两条路。第一在手机上撤销授权后重新插拔进入开发者选项-撤销USB调试授权然后拔线重插弹出对话框时勾选始终允许并确认。第二命令行重启ADB服务adb kill-server再adb start-server有时是Server端缓存了旧的设备状态。这两招解决不了再查驱动但九成unauthorized都在这里解决。6.2 设备offline或反复断开的排查顺序设备显示 offline或者连接一两秒就断开常见原因按出现概率排USB线或接口问题、驱动版本冲突、手机锁屏后休眠断连、多个ADB服务互相抢占。排查顺序我建议这样先换一根数据线尤其要确认是能传数据的数据线而不是纯充电线再换USB口优先主板直出的USB口不要经过拓展坞然后退出电脑上的手机助手类软件最后adb kill-server重启服务。如果手机锁屏后必定断连把开发者选项里的屏幕不休眠打开或者连接时保持屏幕常亮。还有一个容易被忽略的点手机连接电脑后下拉通知栏把USB用途从仅充电改成文件传输/MTP部分机型必须在这个模式下ADB才正常。6.3 夜神等模拟器的ADB连接姿势电脑上装了模拟器模拟器通常自带一套ADB环境系统PATH里的ADB和模拟器内置的ADB版本可能不一致两边容易打架。最常见的现象是模拟器设置里显示未检测到ADB或者电脑端 adb devices 看不到模拟器。解决办法很简单在模拟器设置里找到ADB调试选项一般会显示模拟器监听的端口然后用电脑的 adb connect 127.0.0.1:端口 手动连接。不同模拟器默认端口不同我整理了一份参考模拟器常见ADB端口夜神老版本62001MuMu7555 / 5555雷电5555BlueStacks5555如果连不上先在任务管理器里把所有 adb.exe 进程都结束再用自己本地的ADB重新 connect。连接成功后在模拟器里安装APK、抓日志、模拟点击操作逻辑和真机完全一样。顺带说一句模拟器走网络连接天然没有USB驱动问题新手练手完全可以用模拟器省去一堆物理连接的烦恼。6.4 老款创维电视开ADB的思路智能电视和电视盒子本质是安卓系统自然也可以用ADB。老款创维电视开启ADB的方式不同固件差别很大常见思路绕不开进入工厂菜单这一步。比较普遍的说法是在设置-本机信息页面通过遥控器特定按键组合进入工厂模式然后在工厂菜单里打开ADB开关。也有部分机型需要先安装第三方应用市场再通过市场装一个ADB开关工具来修改系统属性。具体到某一台电视最靠谱的办法是去对应品牌的论坛搜型号工厂模式或型号开启ADB因为每个固件的入口都不一样。开启ADB后如果电视支持网络并且你知道IP就可以adb connect 电视IP:5555连接然后做安装第三方应用、冻结系统应用之类的操作。提醒一句电视精简和手机一样有风险冻结错了可能导致无法开机操作前务必谨慎。如果只是单纯想给电视装个软件直接用U盘装APK可能更省事ADB是给那些被限制安装或者需要移除系统应用的人准备的。最后分享一点个人体会。ADB这个工具刚接触时满眼都是命令、毫无头绪但一旦建立起客户端-服务端-设备端这个框架往后遇到任何问题都有了排查方向——要么是设备没连上要么是权限没给够要么是服务状态坏了。我自己的习惯是把常用命令写成带注释的脚本比如截图并拉回抓日志并保存先查询再冻结应用需要的时候一键执行既省时间又减少出错。新手的正确打开方式不是把教程从头背到尾而是带着一个具体的需求去用用完一次记一次用得多了命令自然就长在脑子里了。
