先说结论ADB这玩意儿真没有你想的那么高门槛。ADB全称Android Debug Bridge翻译成大白话就是“安卓调试桥”说白了它就是一台电脑和安卓手机之间的话务员。你在电脑的cmd窗口里敲一行命令它负责把这句话翻译给手机听再把手机的回答带回给你看。日常能干的活非常多给手机装App、卸载系统自带软件、截图录屏、抓崩溃日志、看电池温度、模拟按键输入文字甚至还能不用root直接冻结那些乱弹广告的应用。这篇文章我按自己这几年的使用习惯把Windows下从零安装ADB到日常高频用法完整走一遍包括环境变量配置、连接设备时最常见的unauthorized报错、logcat日志抓取、冻结系统应用等套路尽量做到你照着敲就能跑通。1. 先搞明白ADB到底是什么玩意儿很多新手第一步就被吓住了觉得这是个什么高深工具。其实你可以把它想象成一条USB数据线加长版——它不只是传文件而是直接让你的电脑获得了一个和安卓系统底层对话的通道。因为Android系统本身是基于Linux内核的很多系统级操作在手机上不方便点但在电脑上敲一行命令就能完成。1.1 ADB的工作方式ADB采用典型的客户端-服务端架构你平时在cmd里敲的adb命令是客户端电脑后台会自动启动一个叫adb server的服务进程默认监听5037端口这个服务进程再通过USB或者Wi-Fi和手机上的adbd守护进程通信。这个过程新手不需要深究但你得知道一件事只要adb server没起来或者被占用你敲命令就会报错。后面第6节我会专门讲端口占用的问题这里先记住5037这个数字后面排查会用得到。1.2 装上它到底能干啥装应用、卸载应用比手机端手动安装快得多还能装到指定用户下。管理文件把电脑文件推到手机或者把手机文件拉到电脑不受MTP协议那个破传输速度的气。截图、录屏一条命令搞定不需要Root不需要第三方App。抓日志开发调试神器App崩溃闪退原因基本上都是靠logcat定位的。冻结/恢复应用不Root也能禁用某些系统应用解决广告和耗电问题。模拟操作模拟点击、滑动、输入文字以前用来做脚本自动化的基础。查看系统信息电池状态、分辨率、内存占用等一条命令就能查。适合谁来用三种人一是安卓开发者ADB是基本功二是喜欢折腾手机的普通玩家想精简系统、抓日志、装框架三是做自动化测试、刷脚本的进阶用户。只要你不是连命令行都没碰过的纯小白这文章你都能跟上。2. Windows下安装ADB其实就三步网上一搜ADB能搜出来一堆“ADB工具包”“ADB一键安装”之类的玩意儿。我建议你少碰那些东西。原因很简单你根本不知道里面打包了多少私货有些还会偷偷改你系统设置。官方渠道拿到的才是干净可靠的。2.1 第一步下载官方Platform-ToolsADB不单独发布安装包它属于Android SDK Platform-Tools的一部分。你需要打开Android开发者官网的Platform-Tools下载页面找到Windows版本下载一个zip压缩包一般叫platform-tools-latest-windows.zip。下载完直接解压解压路径建议放在一个不带空格、不带中文的目录下比如D:\platform-tools。为什么要强调这个因为后面配置环境变量时如果路径里有中文或空格个别情况下会出现一些奇怪的找不到路径的报错实测踩过坑。2.2 第二步快速验证解压结果解压后你会看到一堆文件其中关键的三个是adb.exe —— 最主要的命令行工具fastboot.exe —— 刷机用的工具AdbWinApi.dll / AdbWinUsbApi.dll —— 两个运行时依赖库这时候不要急着配置环境变量先在文件夹地址栏输入cmd并回车会直接在当前目录打开命令行窗口。然后输入adb version如果显示类似Android Debug Bridge version 1.0.41这样的版本号就说明文件本身可以运行问题只出在环境变量上。2.3 第三步配置环境变量重点中的重点为什么一定要配置环境变量如果不配你每次用ADB都得先cd到D:\platform-tools这个目录或者每次都在文件夹地址栏开cmd。配好之后在任何命令行窗口直接敲adb就能用。配置步骤如下右键“此电脑” - 属性 - 高级系统设置。点击“环境变量”。在“系统变量”区域找到Path这一项双击打开。点击“新建”把刚才的路径D:\platform-tools粘贴进去。一路点击“确定”保存。这里有个细节Win10和Win11的Path编辑界面是“新建一行”但老系统Win7里所有路径是分号分隔的你需要在原有值末尾加上英文分号再粘路径。别用中文分号不然系统不认。配置完后关掉所有已打开的命令行窗口重新开一个新的cmd或PowerShell窗口输入adb --help如果屏幕刷出一大段英文帮助信息恭喜ADB安装成功了。如果提示“不是内部或外部命令”或者“无法识别”十有八九是环境变量没生效或者你忘记关旧窗口了重启命令行再试。注意别在命令行窗口还开着的情况下改环境变量改了也不会立刻生效。这是新手最容易踩的坑。3. 让电脑叫得动手机USB调试与设备授权光装了工具还不够你得让手机同意被这台电脑“调试”。这一步牵扯到开发者选项、USB调试授权以及最常见的unauthorized报错我分开说清楚。3.1 开启开发者模式和USB调试不同品牌的手机开启方式大同小异基本都是这个套路打开“设置”找到“关于手机”连续点击“版本号”7次直到提示“您已进入开发者模式”。然后返回设置主页找到新增的“开发者选项”菜单打开“USB调试”。这里有一个很多教程不会提的细节开启USB调试后最好把“仅充电模式下允许ADB调试”这类开关也打开。不然你插上手机后手机默认只是充电模式电脑是识别不到ADB设备的。另外小米、vivo这些品牌还会要求你在开发者选项里登录账号或插入SIM卡才能开启USB调试这是厂商的限制绕不过去属于正常流程。3.2 连接设备与处理unauthorized用数据线把手机连到电脑后第一次执行adb devices这时候大概率会看到这样的输出List of devices attached XXXXXXXXXXXX unauthorized后面的状态是unauthorized翻译过来就是“未授权”。这是因为手机屏幕上弹了一个“是否允许USB调试”的对话框你得在手机上点“允许”并且最好勾选“始终允许使用这台计算机进行调试”否则下次插拔数据线还要重新确认。很多新手在这里卡住明明点了允许可是电脑上还是显示unauthorized。这种情况通常发生在你之前点过“拒绝”的情况下。解决方法是打开手机设置里的“开发者选项”找到“撤销USB调试授权”撤销后再拔插数据线重新弹窗这次一定点“允许”。如果你看到的状态不是unauthorized而是offline说明设备已经授权过但通信链路断了一般是数据线问题或者驱动问题拔了重插试试。如果是一直卡在device未识别状态就需要检查驱动了后面第6节会说。设备状态正常后再执行一次adb devices应该显示List of devices attached XXXXXXXXXXXX device看到device这个单词恭喜你电脑和手机正式建立连接了。3.3 不想插线无线连接也可以现在不少新手机支持无线ADB调试前提是Android 11以上系统。这功能对某些场景非常省事特别是你数据线坏了一半或者笔记本接口不够用的时候。具体步骤先用USB连一次并完成授权然后执行adb tcpip 5555把手机的ADB端口开到5555然后拔掉数据线确保手机和电脑在同一个局域网内再执行adb connect 手机IP地址:5555比如adb connect 192.168.1.100:5555。连上后同样用adb devices确认状态。Android 11以上还有一种更优雅的配对方式。先在手机开发者选项里打开“无线调试”点击“使用配对码配对设备”手机会显示一个6位配对码和一个IP:PORT。电脑端执行adb pair 192.168.1.100:38600按提示输入配对码配对成功后再adb connect你看到的无线调试地址即可。配对只需要一次之后在同一网络下都能直接连。提示无线调试会受路由器网速影响传大文件或抓海量日志时还是优先用数据线更稳。4. 高频命令盘点从装App到抓日志连接成功后就是正式干活的阶段了。我把日常使用频率最高、实用性最强的命令分成几类每一类挑最核心的说附带参数解释和实测效果。4.1 设备与进程管理查看设备列表adb devices最基本也是最先用的命令确认设备状态。后面加-l参数可以显示设备的型号信息方便同时连多台设备时区分。多设备指定目标adb -s 设备序列号 shell getprop ro.product.model当电脑连着多个设备或者手机加模拟器时任何命令前加-s就可以指定给谁执行。不指定的话会报错error: more than one device/emulator。重启ADB服务adb kill-server adb start-server遇到设备异常、端口占用、连接假死时这两条命令是保命绝招。很多玄学问题kill掉server再重启直接就好。4.2 安装和卸载应用安装应用adb install 路径\应用名.apk我实测最常用的参数是-r和-d。如果App已经安装过了不加-r会提示INSTALL_FAILED_ALREADY_EXISTS加上-r表示覆盖安装保留数据重装。加-d表示允许降级安装比如你从1.2版本装回1.1版本不加-d会报错INSTALL_FAILED_VERSION_DOWNGRADE。完整一条一般是这样adb install -r -d 微信.apk卸载应用adb uninstall 包名注意不是让你填应用名是包名。怎么看包名后面冻结应用那一节会专门讲查看包名的方法。卸载系统应用一般会失败这时候可以加--user 0参数只卸载当前用户下的这个应用相当于恢复出厂设置里的“卸载更新”加“禁用”系统本身不会动。4.3 文件传输电脑推文件到手机adb push D:\test.apk /sdcard/把电脑D盘的test.apk推送到手机内部存储根目录。方向别搞反前面是电脑路径后面是手机路径。手机拉文件到电脑adb pull /sdcard/DCIM/IMG_001.jpg E:\backup\遇到中文文件名或路径时Windows下偶尔会乱码那就先用cmd的chcp 65001切到UTF-8编码再执行。4.4 截图和录屏截图adb exec-out screencap -p D:\screen.png这条命令我在抓UI问题时用得多执行速度很快不会有握手过程的卡顿感。如果不用exec-out而用shell screencap输出的是带Windows换行符干扰的二进制图片容易打不开这个细节是实测教训。录屏adb shell screenrecord --bit-rate 4000000 --size 720x1280 /sdcard/video.mp4录屏时如果想要高清码率可以调高默认的20Mbps在复杂界面会卡我一般降到4Mbps画面依然清楚而且不容易掉帧。录完后用adb pull把视频拉出来。4.5 抓取Logcat日志重点App崩溃、闪退、卡死这些疑难杂症在开发者模式下其实都有日志可查。抓取方法adb logcat -v time D:\log.txt-v time的意思是每条日志前面带上时间戳方便定位问题时按时间线索排查。CtrlC结束抓取日志就保存在D:\log.txt里了。如果只想看某一个应用的日志先确认进程号adb shell pidof 包名比如adb shell pidof com.tencent.mm会输出微信的进程ID然后用adb logcat --pid进程ID这样就只会过滤出这个进程的日志不会被系统其他日志淹没。遇到闪退问题最典型的排查姿势是先清空旧日志adb logcat -c然后复现闪退操作再抓日志。否则旧日志可能几万行根本没法定位。提示logcat输出非常快直接看终端界面等于看天书。正确的做法是重定向到文件然后用文本编辑器的搜索功能找FATAL EXCEPTION、AndroidRuntime这两个关键词崩溃原因一般就在附近。5. 进阶玩法冻结应用、设置刷新率、用ADB输入文本前面那些算入门这一节的玩法更骚一点但操作起来依然不复杂而且不需要Root。5.1 不Root冻结系统应用先解释一下原理Android系统里用户可以通过pm命令让某个应用对当前用户不可用。这不是卸载系统文件还在但应用图标会消失、进程不再运行、后台不再唤醒。这就是“冻结”。好处是解冻恢复非常简单不怕手贱误删。查看所有已安装应用的包名adb shell pm list packages输出会很长建议先重定向到文件再慢慢看就这几种看包名的姿势adb shell pm list packages | findstr 关键字 adb shell pm list packages -3第一条按关键字过滤第二条只看第三方应用。想精确区分系统应用用-s参数。冻结应用adb shell pm disable-user --user 0 包名执行后如果输出Package 包名 new state: disabled-user说明冻结成功。这时候桌面图标应该已经消失了App也无法被打开。解冻应用adb shell pm enable 包名像vivo、小米这些手机系统自带了一堆你根本不用但一直占着内存的应用用这个命令冻结掉之后最直接的变化就是待机耗电明显下降。但注意别乱冻结跟系统核心服务相关的包名尤其是com.android.phone电话服务、com.android.systemui系统UI这两个冻结了可能导致系统异常只能恢复出厂设置救回来。彻底卸载预装应用adb shell pm uninstall --user 0 包名卸载和冻结的区别是卸载会把当前用户下的该应用数据清掉。系统更新或恢复出厂设置后应用会自动回来所以不算伤筋动骨。5.2 修改屏幕刷新率很多手机为了省电默认屏幕刷新率只有60Hz哪怕屏幕硬件支持120Hz。通过ADB可以强制调整adb shell settings put system peak_refresh_rate 120.0 adb shell settings put system min_refresh_rate 120.0这两条命令的意思是设置峰值刷新率和最低刷新率都是120Hz。不同手机生效情况不一样有些机型改完后立刻生效有些需要重启一下。改不回来就改回60.0或者执行adb shell settings delete system peak_refresh_rate adb shell settings delete system min_refresh_rate放弃自定义恢复系统默认。这个属于“设置项操作”风险不高但生效与否确实依赖机型改完没效果不用奇怪。5.3 使用ADB代替软件键盘输入文本这个用法在连电视盒子、车机或者触屏失灵的老设备时特别管用。原理是ADB可以把电脑键盘输入的字符直接转换成Android的输入事件不需要依赖屏幕上的软键盘。adb shell input text hello123注意两点一是只能输英文字母和数字空格用%s代替二是中文没法直接输因为Android底层的KeyEvent机制只支持ASCII字符。想输中文就得靠clipboard复制粘贴的方式先通过ADB设置剪贴板再模拟长按粘贴键不过这个过程比较绕日常还是英语和数字场景用得多。模拟点击和滑动adb shell input tap 500 1200 adb shell input swipe 500 1800 500 300 500tap后面跟的是屏幕坐标x和y。swipe后面是起点坐标、终点坐标和滑动耗时毫秒。这组命令配合定时执行脚本就能实现非常基础的自动化操作比如自动打卡、自动刷视频之类的玩法但要注意使用场景合法合规别拿来做破坏平台规则的事。5.4 查看系统状态adb shell dumpsys battery这条命令输出电池健康状态、温度、电压、充电状态等信息判断手机是否“虚电”、是否充电异常比任何第三方App都准。adb shell wm size adb shell wm density查屏幕分辨率和DPI密度。在调试UI适配问题时这两条命令是刚需。6. 常见问题排查与避坑记录用ADB这么多年最难的不是学命令而是遇到问题不知道去哪一步排查。我把踩过的坑整理成了一份实用的排查表按顺序排查大多数问题都能解决。现象常见原因解决方法adb不是内部或外部命令环境变量未配置或未重启命令行检查Path路径确保指向platform-tools目录重启cmd窗口devices显示unauthorized手机未授权或之前点过拒绝在手机开发者选项里撤销USB调试授权后重新连接弹窗时必须点允许并勾选始终允许devices显示offline通信链路异常先执行adb kill-server再adb start-server拔插数据线重启手机USB调试开关设备列表里完全没有手机驱动问题或数据线问题换原装数据线在设备管理器检查是否有带感叹号的ADB设备更新驱动总是显示more than one device电脑同时连接了多个设备每条命令前用-s指定设备序列号或在不用模拟器时把模拟器全关掉5037端口被占用其他程序占用了ADB服务端口执行netstat -ano安装APK报INSTALL_FAILED老错版本冲突或签名不一致加-r覆盖安装加-d降级安装如果还不行卸载后重装截图生成的图片打不开没使用exec-out参数改用adb exec-out screencap -p 路径.png6.1 驱动问题怎么排查Windows对很多安卓手机并不自带驱动特别是国产机型。连接手机后如果设备管理器里出现一个带黄色感叹号的“Android Composite ADB Interface”或者其他未知设备说明驱动没装好。处理方式先到手机官网下载对应品牌的USB驱动比如小米、华为、vivo官网都有专门的驱动页面。如果实在找不到有一个通用方案打开设备管理器右键那个感叹号设备选“更新驱动程序”然后选择“浏览我的电脑以查找驱动程序”再选“让我从计算机上的可用驱动程序列表中选取”如果列表里有Android Device直接选它很多时候能兜底。这一步治标不治本但至少能让adb devices识别到设备。6.2 5037端口占用ADB服务默认监听5037端口。某些国产管理软件、手机助手会偷偷占用这个端口。现象是adb devices卡住不动或者提示cannot bind to 127.0.0.1:5037。排查命令netstat -ano | findstr 5037查看输出的最后一列PID然后打开任务管理器找到对应PID的进程结束掉即可。如果这个进程是某个手机助手建议直接在启动项里禁用不然每用一次ADB就要手动杀一次。6.3 系统提示找不到设备如果adb devices输出显示的不是unauthorized而是空列表并且设备管理器的端口设备下能看到“Android Composite ADB Interface”但没有感叹号那就大概率还是USB模式的问题。把手机的USB连接模式从“仅充电”切到“文件传输(MTP)”再试。不少手机只有在MTP模式下才会把ADB接口暴露出来。提示优先使用手机原装数据线。很多所谓的“数据线”实际上只能充电里面的数据线芯是断的这种线不管你怎么折腾驱动都连不上。6.4 ADB服务自动退出有时候刚执行完adb命令下一次再执行又提示服务未启动这是典型的Windows防火墙拦截了ADB服务进程。第一次运行adb时防火墙会弹窗询问是否允许访问网络如果你点了“取消”后面adb server就始终被拦截。解决方法进入“控制面板 - Windows Defender防火墙 - 允许应用通过防火墙”找到并勾选ADB相关的几个条目然后用管理员身份重新打开cmd并执行adb start-server。最后分享一个多年用下来的小习惯我每次给手机装完新环境都会先执行这样一套顺序先adb kill-server再adb start-server然后adb devices。看似多此一举实际上能避免一多半的“莫名其妙连不上”的问题。特别是你电脑上装过各种手机助手、模拟器之后这些程序会搅乱ADB的全局状态导致设备明明插着却识别不到。用了这么多年ADB最大的体会是它强不强不取决于命令记了多少而是遇到问题时有没有一套稳定的排查思路。别看命令行窗口黑乎乎的只要你摸清了设备状态的四种含义空、unauthorized、offline、device再结合端口、驱动两个排查方向Windows下几乎没有什么ADB问题可以拦住你超过十分钟。对了如果在第4节抓logcat时发现日志全是乱码试试先执行chcp 65001切到UTF-8编码再重新抓取。这个小细节我印象挺深因为当初为了排查编码问题白白浪费了好几个小时。
先说结论ADB这玩意儿真没有你想的那么高门槛。ADB全称Android Debug Bridge翻译成大白话就是“安卓调试桥”说白了它就是一台电脑和安卓手机之间的话务员。你在电脑的cmd窗口里敲一行命令它负责把这句话翻译给手机听再把手机的回答带回给你看。日常能干的活非常多给手机装App、卸载系统自带软件、截图录屏、抓崩溃日志、看电池温度、模拟按键输入文字甚至还能不用root直接冻结那些乱弹广告的应用。这篇文章我按自己这几年的使用习惯把Windows下从零安装ADB到日常高频用法完整走一遍包括环境变量配置、连接设备时最常见的unauthorized报错、logcat日志抓取、冻结系统应用等套路尽量做到你照着敲就能跑通。1. 先搞明白ADB到底是什么玩意儿很多新手第一步就被吓住了觉得这是个什么高深工具。其实你可以把它想象成一条USB数据线加长版——它不只是传文件而是直接让你的电脑获得了一个和安卓系统底层对话的通道。因为Android系统本身是基于Linux内核的很多系统级操作在手机上不方便点但在电脑上敲一行命令就能完成。1.1 ADB的工作方式ADB采用典型的客户端-服务端架构你平时在cmd里敲的adb命令是客户端电脑后台会自动启动一个叫adb server的服务进程默认监听5037端口这个服务进程再通过USB或者Wi-Fi和手机上的adbd守护进程通信。这个过程新手不需要深究但你得知道一件事只要adb server没起来或者被占用你敲命令就会报错。后面第6节我会专门讲端口占用的问题这里先记住5037这个数字后面排查会用得到。1.2 装上它到底能干啥装应用、卸载应用比手机端手动安装快得多还能装到指定用户下。管理文件把电脑文件推到手机或者把手机文件拉到电脑不受MTP协议那个破传输速度的气。截图、录屏一条命令搞定不需要Root不需要第三方App。抓日志开发调试神器App崩溃闪退原因基本上都是靠logcat定位的。冻结/恢复应用不Root也能禁用某些系统应用解决广告和耗电问题。模拟操作模拟点击、滑动、输入文字以前用来做脚本自动化的基础。查看系统信息电池状态、分辨率、内存占用等一条命令就能查。适合谁来用三种人一是安卓开发者ADB是基本功二是喜欢折腾手机的普通玩家想精简系统、抓日志、装框架三是做自动化测试、刷脚本的进阶用户。只要你不是连命令行都没碰过的纯小白这文章你都能跟上。2. Windows下安装ADB其实就三步网上一搜ADB能搜出来一堆“ADB工具包”“ADB一键安装”之类的玩意儿。我建议你少碰那些东西。原因很简单你根本不知道里面打包了多少私货有些还会偷偷改你系统设置。官方渠道拿到的才是干净可靠的。2.1 第一步下载官方Platform-ToolsADB不单独发布安装包它属于Android SDK Platform-Tools的一部分。你需要打开Android开发者官网的Platform-Tools下载页面找到Windows版本下载一个zip压缩包一般叫platform-tools-latest-windows.zip。下载完直接解压解压路径建议放在一个不带空格、不带中文的目录下比如D:\platform-tools。为什么要强调这个因为后面配置环境变量时如果路径里有中文或空格个别情况下会出现一些奇怪的找不到路径的报错实测踩过坑。2.2 第二步快速验证解压结果解压后你会看到一堆文件其中关键的三个是adb.exe —— 最主要的命令行工具fastboot.exe —— 刷机用的工具AdbWinApi.dll / AdbWinUsbApi.dll —— 两个运行时依赖库这时候不要急着配置环境变量先在文件夹地址栏输入cmd并回车会直接在当前目录打开命令行窗口。然后输入adb version如果显示类似Android Debug Bridge version 1.0.41这样的版本号就说明文件本身可以运行问题只出在环境变量上。2.3 第三步配置环境变量重点中的重点为什么一定要配置环境变量如果不配你每次用ADB都得先cd到D:\platform-tools这个目录或者每次都在文件夹地址栏开cmd。配好之后在任何命令行窗口直接敲adb就能用。配置步骤如下右键“此电脑” - 属性 - 高级系统设置。点击“环境变量”。在“系统变量”区域找到Path这一项双击打开。点击“新建”把刚才的路径D:\platform-tools粘贴进去。一路点击“确定”保存。这里有个细节Win10和Win11的Path编辑界面是“新建一行”但老系统Win7里所有路径是分号分隔的你需要在原有值末尾加上英文分号再粘路径。别用中文分号不然系统不认。配置完后关掉所有已打开的命令行窗口重新开一个新的cmd或PowerShell窗口输入adb --help如果屏幕刷出一大段英文帮助信息恭喜ADB安装成功了。如果提示“不是内部或外部命令”或者“无法识别”十有八九是环境变量没生效或者你忘记关旧窗口了重启命令行再试。注意别在命令行窗口还开着的情况下改环境变量改了也不会立刻生效。这是新手最容易踩的坑。3. 让电脑叫得动手机USB调试与设备授权光装了工具还不够你得让手机同意被这台电脑“调试”。这一步牵扯到开发者选项、USB调试授权以及最常见的unauthorized报错我分开说清楚。3.1 开启开发者模式和USB调试不同品牌的手机开启方式大同小异基本都是这个套路打开“设置”找到“关于手机”连续点击“版本号”7次直到提示“您已进入开发者模式”。然后返回设置主页找到新增的“开发者选项”菜单打开“USB调试”。这里有一个很多教程不会提的细节开启USB调试后最好把“仅充电模式下允许ADB调试”这类开关也打开。不然你插上手机后手机默认只是充电模式电脑是识别不到ADB设备的。另外小米、vivo这些品牌还会要求你在开发者选项里登录账号或插入SIM卡才能开启USB调试这是厂商的限制绕不过去属于正常流程。3.2 连接设备与处理unauthorized用数据线把手机连到电脑后第一次执行adb devices这时候大概率会看到这样的输出List of devices attached XXXXXXXXXXXX unauthorized后面的状态是unauthorized翻译过来就是“未授权”。这是因为手机屏幕上弹了一个“是否允许USB调试”的对话框你得在手机上点“允许”并且最好勾选“始终允许使用这台计算机进行调试”否则下次插拔数据线还要重新确认。很多新手在这里卡住明明点了允许可是电脑上还是显示unauthorized。这种情况通常发生在你之前点过“拒绝”的情况下。解决方法是打开手机设置里的“开发者选项”找到“撤销USB调试授权”撤销后再拔插数据线重新弹窗这次一定点“允许”。如果你看到的状态不是unauthorized而是offline说明设备已经授权过但通信链路断了一般是数据线问题或者驱动问题拔了重插试试。如果是一直卡在device未识别状态就需要检查驱动了后面第6节会说。设备状态正常后再执行一次adb devices应该显示List of devices attached XXXXXXXXXXXX device看到device这个单词恭喜你电脑和手机正式建立连接了。3.3 不想插线无线连接也可以现在不少新手机支持无线ADB调试前提是Android 11以上系统。这功能对某些场景非常省事特别是你数据线坏了一半或者笔记本接口不够用的时候。具体步骤先用USB连一次并完成授权然后执行adb tcpip 5555把手机的ADB端口开到5555然后拔掉数据线确保手机和电脑在同一个局域网内再执行adb connect 手机IP地址:5555比如adb connect 192.168.1.100:5555。连上后同样用adb devices确认状态。Android 11以上还有一种更优雅的配对方式。先在手机开发者选项里打开“无线调试”点击“使用配对码配对设备”手机会显示一个6位配对码和一个IP:PORT。电脑端执行adb pair 192.168.1.100:38600按提示输入配对码配对成功后再adb connect你看到的无线调试地址即可。配对只需要一次之后在同一网络下都能直接连。提示无线调试会受路由器网速影响传大文件或抓海量日志时还是优先用数据线更稳。4. 高频命令盘点从装App到抓日志连接成功后就是正式干活的阶段了。我把日常使用频率最高、实用性最强的命令分成几类每一类挑最核心的说附带参数解释和实测效果。4.1 设备与进程管理查看设备列表adb devices最基本也是最先用的命令确认设备状态。后面加-l参数可以显示设备的型号信息方便同时连多台设备时区分。多设备指定目标adb -s 设备序列号 shell getprop ro.product.model当电脑连着多个设备或者手机加模拟器时任何命令前加-s就可以指定给谁执行。不指定的话会报错error: more than one device/emulator。重启ADB服务adb kill-server adb start-server遇到设备异常、端口占用、连接假死时这两条命令是保命绝招。很多玄学问题kill掉server再重启直接就好。4.2 安装和卸载应用安装应用adb install 路径\应用名.apk我实测最常用的参数是-r和-d。如果App已经安装过了不加-r会提示INSTALL_FAILED_ALREADY_EXISTS加上-r表示覆盖安装保留数据重装。加-d表示允许降级安装比如你从1.2版本装回1.1版本不加-d会报错INSTALL_FAILED_VERSION_DOWNGRADE。完整一条一般是这样adb install -r -d 微信.apk卸载应用adb uninstall 包名注意不是让你填应用名是包名。怎么看包名后面冻结应用那一节会专门讲查看包名的方法。卸载系统应用一般会失败这时候可以加--user 0参数只卸载当前用户下的这个应用相当于恢复出厂设置里的“卸载更新”加“禁用”系统本身不会动。4.3 文件传输电脑推文件到手机adb push D:\test.apk /sdcard/把电脑D盘的test.apk推送到手机内部存储根目录。方向别搞反前面是电脑路径后面是手机路径。手机拉文件到电脑adb pull /sdcard/DCIM/IMG_001.jpg E:\backup\遇到中文文件名或路径时Windows下偶尔会乱码那就先用cmd的chcp 65001切到UTF-8编码再执行。4.4 截图和录屏截图adb exec-out screencap -p D:\screen.png这条命令我在抓UI问题时用得多执行速度很快不会有握手过程的卡顿感。如果不用exec-out而用shell screencap输出的是带Windows换行符干扰的二进制图片容易打不开这个细节是实测教训。录屏adb shell screenrecord --bit-rate 4000000 --size 720x1280 /sdcard/video.mp4录屏时如果想要高清码率可以调高默认的20Mbps在复杂界面会卡我一般降到4Mbps画面依然清楚而且不容易掉帧。录完后用adb pull把视频拉出来。4.5 抓取Logcat日志重点App崩溃、闪退、卡死这些疑难杂症在开发者模式下其实都有日志可查。抓取方法adb logcat -v time D:\log.txt-v time的意思是每条日志前面带上时间戳方便定位问题时按时间线索排查。CtrlC结束抓取日志就保存在D:\log.txt里了。如果只想看某一个应用的日志先确认进程号adb shell pidof 包名比如adb shell pidof com.tencent.mm会输出微信的进程ID然后用adb logcat --pid进程ID这样就只会过滤出这个进程的日志不会被系统其他日志淹没。遇到闪退问题最典型的排查姿势是先清空旧日志adb logcat -c然后复现闪退操作再抓日志。否则旧日志可能几万行根本没法定位。提示logcat输出非常快直接看终端界面等于看天书。正确的做法是重定向到文件然后用文本编辑器的搜索功能找FATAL EXCEPTION、AndroidRuntime这两个关键词崩溃原因一般就在附近。5. 进阶玩法冻结应用、设置刷新率、用ADB输入文本前面那些算入门这一节的玩法更骚一点但操作起来依然不复杂而且不需要Root。5.1 不Root冻结系统应用先解释一下原理Android系统里用户可以通过pm命令让某个应用对当前用户不可用。这不是卸载系统文件还在但应用图标会消失、进程不再运行、后台不再唤醒。这就是“冻结”。好处是解冻恢复非常简单不怕手贱误删。查看所有已安装应用的包名adb shell pm list packages输出会很长建议先重定向到文件再慢慢看就这几种看包名的姿势adb shell pm list packages | findstr 关键字 adb shell pm list packages -3第一条按关键字过滤第二条只看第三方应用。想精确区分系统应用用-s参数。冻结应用adb shell pm disable-user --user 0 包名执行后如果输出Package 包名 new state: disabled-user说明冻结成功。这时候桌面图标应该已经消失了App也无法被打开。解冻应用adb shell pm enable 包名像vivo、小米这些手机系统自带了一堆你根本不用但一直占着内存的应用用这个命令冻结掉之后最直接的变化就是待机耗电明显下降。但注意别乱冻结跟系统核心服务相关的包名尤其是com.android.phone电话服务、com.android.systemui系统UI这两个冻结了可能导致系统异常只能恢复出厂设置救回来。彻底卸载预装应用adb shell pm uninstall --user 0 包名卸载和冻结的区别是卸载会把当前用户下的该应用数据清掉。系统更新或恢复出厂设置后应用会自动回来所以不算伤筋动骨。5.2 修改屏幕刷新率很多手机为了省电默认屏幕刷新率只有60Hz哪怕屏幕硬件支持120Hz。通过ADB可以强制调整adb shell settings put system peak_refresh_rate 120.0 adb shell settings put system min_refresh_rate 120.0这两条命令的意思是设置峰值刷新率和最低刷新率都是120Hz。不同手机生效情况不一样有些机型改完后立刻生效有些需要重启一下。改不回来就改回60.0或者执行adb shell settings delete system peak_refresh_rate adb shell settings delete system min_refresh_rate放弃自定义恢复系统默认。这个属于“设置项操作”风险不高但生效与否确实依赖机型改完没效果不用奇怪。5.3 使用ADB代替软件键盘输入文本这个用法在连电视盒子、车机或者触屏失灵的老设备时特别管用。原理是ADB可以把电脑键盘输入的字符直接转换成Android的输入事件不需要依赖屏幕上的软键盘。adb shell input text hello123注意两点一是只能输英文字母和数字空格用%s代替二是中文没法直接输因为Android底层的KeyEvent机制只支持ASCII字符。想输中文就得靠clipboard复制粘贴的方式先通过ADB设置剪贴板再模拟长按粘贴键不过这个过程比较绕日常还是英语和数字场景用得多。模拟点击和滑动adb shell input tap 500 1200 adb shell input swipe 500 1800 500 300 500tap后面跟的是屏幕坐标x和y。swipe后面是起点坐标、终点坐标和滑动耗时毫秒。这组命令配合定时执行脚本就能实现非常基础的自动化操作比如自动打卡、自动刷视频之类的玩法但要注意使用场景合法合规别拿来做破坏平台规则的事。5.4 查看系统状态adb shell dumpsys battery这条命令输出电池健康状态、温度、电压、充电状态等信息判断手机是否“虚电”、是否充电异常比任何第三方App都准。adb shell wm size adb shell wm density查屏幕分辨率和DPI密度。在调试UI适配问题时这两条命令是刚需。6. 常见问题排查与避坑记录用ADB这么多年最难的不是学命令而是遇到问题不知道去哪一步排查。我把踩过的坑整理成了一份实用的排查表按顺序排查大多数问题都能解决。现象常见原因解决方法adb不是内部或外部命令环境变量未配置或未重启命令行检查Path路径确保指向platform-tools目录重启cmd窗口devices显示unauthorized手机未授权或之前点过拒绝在手机开发者选项里撤销USB调试授权后重新连接弹窗时必须点允许并勾选始终允许devices显示offline通信链路异常先执行adb kill-server再adb start-server拔插数据线重启手机USB调试开关设备列表里完全没有手机驱动问题或数据线问题换原装数据线在设备管理器检查是否有带感叹号的ADB设备更新驱动总是显示more than one device电脑同时连接了多个设备每条命令前用-s指定设备序列号或在不用模拟器时把模拟器全关掉5037端口被占用其他程序占用了ADB服务端口执行netstat -ano安装APK报INSTALL_FAILED老错版本冲突或签名不一致加-r覆盖安装加-d降级安装如果还不行卸载后重装截图生成的图片打不开没使用exec-out参数改用adb exec-out screencap -p 路径.png6.1 驱动问题怎么排查Windows对很多安卓手机并不自带驱动特别是国产机型。连接手机后如果设备管理器里出现一个带黄色感叹号的“Android Composite ADB Interface”或者其他未知设备说明驱动没装好。处理方式先到手机官网下载对应品牌的USB驱动比如小米、华为、vivo官网都有专门的驱动页面。如果实在找不到有一个通用方案打开设备管理器右键那个感叹号设备选“更新驱动程序”然后选择“浏览我的电脑以查找驱动程序”再选“让我从计算机上的可用驱动程序列表中选取”如果列表里有Android Device直接选它很多时候能兜底。这一步治标不治本但至少能让adb devices识别到设备。6.2 5037端口占用ADB服务默认监听5037端口。某些国产管理软件、手机助手会偷偷占用这个端口。现象是adb devices卡住不动或者提示cannot bind to 127.0.0.1:5037。排查命令netstat -ano | findstr 5037查看输出的最后一列PID然后打开任务管理器找到对应PID的进程结束掉即可。如果这个进程是某个手机助手建议直接在启动项里禁用不然每用一次ADB就要手动杀一次。6.3 系统提示找不到设备如果adb devices输出显示的不是unauthorized而是空列表并且设备管理器的端口设备下能看到“Android Composite ADB Interface”但没有感叹号那就大概率还是USB模式的问题。把手机的USB连接模式从“仅充电”切到“文件传输(MTP)”再试。不少手机只有在MTP模式下才会把ADB接口暴露出来。提示优先使用手机原装数据线。很多所谓的“数据线”实际上只能充电里面的数据线芯是断的这种线不管你怎么折腾驱动都连不上。6.4 ADB服务自动退出有时候刚执行完adb命令下一次再执行又提示服务未启动这是典型的Windows防火墙拦截了ADB服务进程。第一次运行adb时防火墙会弹窗询问是否允许访问网络如果你点了“取消”后面adb server就始终被拦截。解决方法进入“控制面板 - Windows Defender防火墙 - 允许应用通过防火墙”找到并勾选ADB相关的几个条目然后用管理员身份重新打开cmd并执行adb start-server。最后分享一个多年用下来的小习惯我每次给手机装完新环境都会先执行这样一套顺序先adb kill-server再adb start-server然后adb devices。看似多此一举实际上能避免一多半的“莫名其妙连不上”的问题。特别是你电脑上装过各种手机助手、模拟器之后这些程序会搅乱ADB的全局状态导致设备明明插着却识别不到。用了这么多年ADB最大的体会是它强不强不取决于命令记了多少而是遇到问题时有没有一套稳定的排查思路。别看命令行窗口黑乎乎的只要你摸清了设备状态的四种含义空、unauthorized、offline、device再结合端口、驱动两个排查方向Windows下几乎没有什么ADB问题可以拦住你超过十分钟。对了如果在第4节抓logcat时发现日志全是乱码试试先执行chcp 65001切到UTF-8编码再重新抓取。这个小细节我印象挺深因为当初为了排查编码问题白白浪费了好几个小时。
