简介adb 1.0.41 版本以 platform-tools 工具链形式打包面向安卓开发者与需要深入管理设备的进阶用户用于解决应用安装、调试、设备状态查询与系统分区维护等日常任务。压缩包共 15 个文件大小 5.93MB以 adb.exe、fastboot.exe 等 exe 可执行程序为主辅以 AdbWinApi.dll、AdbWinUsbApi.dll 等运行库以及 NOTICE.txt、source.properties、mke2fs.conf 等说明与配置信息结构简洁便于单独部署和调用。该版本对跨安卓版本兼容性、数据传输性能和已知问题进行了优化可作为开发调试与设备维护的常备工具。已有 1395 人学习适合希望系统掌握 adb 命令、排查连接异常或进行设备刷机/分区操作的用户。通过这份工具包可快速搭建命令行调试环境覆盖从应用安装、日志抓取到 fastboot 底层操作的完整链路。1. 为什么说 adb 1.0.41 是绕不开的经典版本如果你这两年查 adb 相关教程大概率会看到各种命令示例里标注adb 1.0.41这个版本号。这不是偶然而是因为 1.0.41 恰好对应了一个稳定性非常好的 platform-tools 发布节点很多教程、自动化脚本、电视盒子刷机工具甚至厂商的出厂测试脚本都默认以这个版本作为基准。我在实际项目里同时维护过三个版本的 adb 环境最终固定下来长期使用的也是 1.0.41——所以这次干脆把关于这个版本的东西一次说透。先解释一下 adb 是什么。adb 全称 Android Debug Bridge是 Android 调试桥一个走客户端-服务端-守护进程架构的命令行工具。你在电脑上敲 adb 命令它通过 USB 或 TCP 和手机、电视、机顶盒上的 adbd 守护进程通信从而执行安装应用、拷贝文件、看日志、模拟点击这些操作。官方并没有把 adb 单独拆成一个大版本号而是跟随 Android SDK Platform-Tools 一起发布版本号用 adb 自带的版本信息来标识比如 1.0.41。这里有个细节值得注意同一个 1.0.41 版本在不同时期的 Platform-Tools 包里内置的指令集其实是有细微出入的。比如早期一些安卓 13 的测试机型需要较新的 adb 才能正确识别而 1.0.41 之后的版本也一直没有在命令行交互上做破坏性变更。所以它成了一个安全牌——不管你是给手机刷机、连车机调试还是手动清掉系统预装应用用 1.0.41 基本不会出现兼容性翻车。那怎么知道自己电脑上的 adb 是不是 1.0.41直接在终端执行adb version输出里会出现类似这样的一行Android Debug Bridge version 1.0.41 Version 33.0.1-9640601只要第一行是 1.0.41就算这个版本的 adb 本体。后面那串 Version 是 platform-tools 的构建编号不同批次会有差异不影响使用。如果你发现自己电脑上的 adb 版本特别老比如 1.0.32 或更早我建议直接升级到现在依然满足 1.0.41 状态的包。过老的版本在连接安卓 10 以上的设备时经常遇到device unauthorized或insufficient permissions这类问题根因往往不是设备设置错了而是 adb 协议版本和设备的 SELinux 策略不匹配。2. 从零到能跑驱动、platform-tools 与环境变量配置很多新手被卡住不是卡在命令本身而是连第一步都没走通。这里我把整套环境搭建按 Windows、macOS、Linux 三种系统分别讲清楚。2.1 下载和解压 platform-tools不要去随便找第三方下载站直接去 Android 开发者官网的 SDK Platform Tools 页面下载对应系统的压缩包就好。这个页面会自动识别你的操作系统也可以手动切。下载之后解压到一个路径里路径里不要有空格和中文这条建议非常重要。我见过有人在 Windows 上把 adb 放在C:\Program Files (x86)\adb tools\这类位置后续写脚本时各种引号转义问题折腾半天才发现是路径的锅。解压后你会看到这样一组核心文件adb.exeAdbWinApi.dllAdbWinUsbApi.dllfastboot.exe后两个 dll 在 Windows 上尤其关键有的精简版工具只丢一个 adb.exe 出来跑起来就会报找不到 AdbWinApi.dll原因就是缺了这两个依赖库。2.2 Windows 驱动代码 10 的根源与解法Windows 上最折磨人的环节是驱动。手机插上 USB 后如果设备管理器里出现一个黄色感叹号的Android Composite ADB Interface或者提示代码 10设备无法启动那说明驱动没有正确安装。这个问题在 Win10/Win11 上依然高发根因是系统自带的 USB 驱动和手机厂商的 ADB 接口描述符没对上。解决办法分两个方向如果手机厂商提供了官方驱动优先装官方的。华为、小米、OPPO、vivo 都有自己的 USB 驱动包装完重启再插线。没有官方驱动或懒得找直接用 platform-tools 目录里那个winusb兼容方案。具体做法是设备管理器里右键更新驱动选择浏览我的电脑以查找驱动程序然后手动指向C:\Android\platform-tools\usb_driver如果没有这个目录说明你下载的是纯命令行包需要另下 Google USB Driver。装完如果还是代码 10就把设备从系统里彻底卸载重启电脑重新插线让系统从头识别一遍。注意代码 10 还有一种隐蔽成因——前置 USB 3.0 接口供电不稳。特别是笔记本建议直接插机箱后置 USB 口或者用原装数据线别用那种带充电功能的数据线很多标注支持快充的线里边的数据线芯其实非常细信号衰减严重。2.3 环境变量配置解压完只是第一步如果不配环境变量每次都得 cd 到 platform-tools 目录里才能敲 adb 命令太笨了。以 Windows 为例复制解压路径比如C:\Android\platform-tools右键此电脑→ 属性 → 高级系统设置 → 环境变量在系统变量里找到 Path点编辑新建一条粘贴路径一路确定保存新开一个 CMD 窗口输入adb version验证macOS 和 Linux 更简单建议直接把 platform-tools 放到~/platform-tools然后在 shell 配置里加一行export PATH$PATH:~/platform-toolsLinux 下还有一种更省事的方法用包管理器直接装sudo apt install android-tools-adb不过注意Linux 发行版仓库里的 adb 版本可能不是 1.0.41有些是基于老版本改的功能和兼容性都差一点。如果遇到识别不了新设备还是回到官网下官方包更稳。2.4 验证连通性环境配好之后把手机调到开发者模式打开 USB 调试用数据线连接电脑然后执行adb devices第一次连接时手机上会弹一个允许 USB 调试吗的授权框勾选一律允许点确定。这时候再执行adb devices输出里应该能看到List of devices attached * daemon not running; starting now at tcp:5037 * daemon started successfully 1234567890abcdef device注意状态列是device而不是unauthorized或offline到这一步环境就通了。3. 核心命令矩阵从设备检测到日志抓取adb 命令很多但真正高频的其实就集中在十几个。下面按功能分组每一组我都标注了实际使用场景和注意事项。3.1 设备与连接adb devices # 列出已连接设备 adb devices -l # 显示设备详情包括型号、usb 端口 adb kill-server # 杀掉 adb 服务进程 adb start-server # 启动 adb 服务进程 adb connect 192.168.1.10:5555 # 通过 Wi-Fi 连接设备 adb disconnect # 断开无线连接这里有个坑很多设备默认不开 5555 端口的无线调试需要先用 USB 连接执行adb tcpip 5555拔掉线才能用adb connect。Android 11 之后还有无线调试功能那个用的是随机端口需要开发者选项里的配对码配合这里不展开。3.2 应用管理adb install -r app.apk # 安装并保留数据 adb install -d app.apk # 允许降级安装 adb uninstall com.example.app # 卸载应用 adb uninstall -k com.example.app # 卸载但保留数据 adb shell pm list packages # 列出所有已安装包名 adb shell pm list packages -3 # 只列出第三方应用 adb shell pm clear com.example.app # 清除应用数据安装应用时最容易踩的坑是签名冲突。如果设备上已装的是正式签名包你拿一个 debug 签名的包执行adb install -r会报INSTALL_FAILED_UPDATE_INCOMPATIBLE这时候得先卸载旧的或者用-r -d组合老版本。降级安装还要注意很多手机 ROM 对降级有额外限制连adb install -d都救不了这种得走系统设置里的允许应用降级开关。3.3 文件传输adb push 本地文件 /sdcard/目标路径 # 从电脑推到设备 adb pull /sdcard/目标文件 本地路径 # 从设备拉到电脑一个常见需求是把视频、图片导出来。比如手机里有截图存在/sdcard/Pictures/Screenshots/想一次性拉取全部adb pull /sdcard/Pictures/Screenshots/ D:\screenshots注意 push/pull 目录时会递归拷贝但如果目标目录已存在同名文件行为可能和预期不太一样。稳妥起见我一般先把设备文件名查清楚再拉。3.4 截图与录屏adb exec-out screencap -p screen.png # 截图并在电脑上生成文件 adb exec-out screencap -p /sdcard/screen.png # 先存到设备再拉出来 adb shell screenrecord /sdcard/video.mp4 --time-limit 10 # 录屏 10 秒截图这里有个性能相关的细节用adb exec-out而不是adb shell screencap是因为exec-out会直接输出二进制流到终端避免多余的转义处理在大量截图时速度明显更快。3.5 Shell 与系统操作adb shell # 进入设备的 shell 环境 adb shell ls /sdcard/ # 查看设备目录 adb shell getprop ro.product.model # 查看机型 adb shell dumpsys battery # 查看电池状态 adb shell input keyevent 26 # 模拟电源键 adb shell input swipe 500 1500 500 300 # 模拟滑动 adb shell input text hello # 输入文本 adb shell am start -n 包名/Activity全名 # 启动指定界面 adb shell am force-stop 包名 # 强制停止应用 adb shell wm size # 查看分辨率input text输入中文会失败因为它走的是 keycode 映射只支持 ASCII。要输中文得借助 ADB Keyboard 这类第三方输入法。3.6 日志抓取adb logcat -c # 清空日志缓冲区 adb logcat -d app.log # 导出当前所有缓存日志 adb logcat *:E # 只看 Error 级别日志 adb logcat -s TagName # 过滤指定 Tag adb logcat --pid1234 # 按进程 ID 过滤抓崩溃日志是我日常用的最多的操作。当 App 闪退后最有效的命令是adb logcat -d -b crash-b crash指定读取崩溃日志缓冲区比单纯logcat输出再手工翻找快得多。3.7 代理与网络设置热搜词里出现adb 重置代理对应命令是adb shell settings put global http_proxy 192.168.1.100:8888 # 设置代理 adb shell settings put global http_proxy :0 # 清空代理有些代理工具会通过 adb 给设备设置全局代理用完必须手动重置否则手机后续所有 HTTP 流量都会往一个已经失效的代理上撞表现为能上网但无法访问 App 内容。所以重置代理这条命令值得记熟。4. 高频问题排查unauthorized、无设备、驱动失败这一节是我被问得最多的救命环节也是热搜词里出现频率最高的几类问题。我把它们归成三类分别给出完整的排查链路和解决建议。4.1 设备状态是 unauthorizedadb devices显示XXXXXXXXXXXX unauthorized手机也弹出过授权框但你点了允许之后马上又弹或者干脆没弹框。这类问题大概率是 RSA 指纹不匹配造成的常见于换电脑、重装系统、或曾经在手机上删过调试授权。标准排查顺序手机上撤销所有 USB 调试授权开发者选项 → 撤销 USB 调试授权确认重新插线。电脑端清理 adb key之后重新生成配对adb kill-server rm ~/.android/adbkey ~/.android/adbkey.pub adb start-server adb devicesWindows 下路径是C:\Users\你的用户名\.android\adbkey。如果还是不弹框换一根数据线或者换个 USB 接口。这一步看起来像玄学但真的解决过不少问题——很多数据线只有充电线路没有数据线路或者数据线路在弯折处断了一股导致 USB 设备枚举时只握手了几毫秒就断开。4.2 无设备被列出或 devices 是空的adb devices输出为空或者只有本机* daemon started successfully。这不是 adb 的问题是 USB 链路没通。按以下顺序逐层排查设备管理器里有没有出现Android开头的设备没有说明线或接口不行有但带感叹号说明驱动不对参考前面驱动章节的代码 10 处理。手机有没有打开 USB 调试开发者选项可能在这个 ROM 里被隐藏了通常是连续点击版本号7 次开启。手机息屏状态下USB 协议可能被系统协商成纯充电模式。在开发者选项里找到默认 USB 配置改成文件传输或USB 调试。如果以上全试过还不行运行一遍adb kill-server然后重新插线再adb devices。服务偶尔会卡在某个死状态重启服务能解决很多诡异问题。4.3 老设备 / 电视盒子 / 车机连不上很多电视盒子、车机、智能手表的调试方式和手机不完全一样。电视盒子如果没有在设置里打开 ADB 开关有些叫远程调试或精简模式默认是不开 5555 端口的。需要用遥控器进设置找到对应入口打开才能用adb connect方式接入。还有一类特殊场景是机顶盒的固件为了省空间直接砍掉了 adbd 进程的某些 capability导致adb shell进去之后一堆命令不存在比如pm、am都没有响应。这种情况不是 adb 版本问题是固件本身残缺。换个思路看看固件是不是有官方精简版或者找配套的厂商工具而不是硬啃 adb。4.4 adb 端口被占用运行任意 adb 命令卡住不动执行adb start-server提示端口被占用多半是 5037 端口被某个程序抢了。排查和解决netstat -ano | findstr 5037 # Windows 下查看谁占用了 5037 taskkill /PID 该PID /FmacOS/Linux 下用lsof -i:5037查占用进程kill 掉即可。有些国产手机助手比如各种应用市场自带的手机连接组件会抢占 5037 端口最好直接关掉再用 adb否则每次都得手动杀进程。5. 进阶玩法与自动化脚本到这里adb 的基本功已经够了。但如果你只想用 adb 解决一个重复性任务那就应该尝试写脚本。下面分享两个我真实在用的场景可以直接套用。5.1 一键截图并打时间戳写个简单的批处理脚本每次执行自动给截图文件加上日期时间避免同名覆盖echo off for /f tokens2 delims %%a in (wmic OS Get localdatetime /value) do set dt%%a set datetime%dt:~0,8%_%dt:~8,6% adb exec-out screencap -p screenshot_%datetime%.png在手机状态比较干净的情况下整个过程 1 秒内完成比手机自带截图再传到电脑快了不只一个量级。5.2 自动重连与批量测试如果你要连续调试多个设备或者设备偶尔会因为息屏/USB 休眠掉线可以写一个循环脚本掉线自动重连for /l %%i in (1,1,100) do ( adb devices | findstr device$ nul if %errorlevel% NEQ 0 ( echo device disconnected, reconnecting... adb reconnect timeout /t 3 ) timeout /t 10 )这类脚本在做长时间自动遍历测试时很有用免得人坐在那里盯屏幕每隔几分钟手动敲一次 adb devices。5.3 结合系统工具实现设备信息采集要给一批手机做设备信息归档可以组合 getpropadb shell getprop ro.product.model adb shell getprop ro.build.version.release adb shell getprop ro.serialno写个循环把多台设备的输出汇总for device in $(adb devices | grep -w device | cut -f1); do echo $device adb -s $device shell getprop ro.product.model adb -s $device shell getprop ro.build.version.release done注意-s参数可以指定具体设备这个参数在多设备场景下是刚需不然 adb 会报more than one device错误。6. 关于 adb 版本选择与兼容性的一些体会回到开头说的 1.0.41。很多新手会有一种误区觉得 adb 版本越新越好所以每次都去装最新的 platform-tools。其实 adb 这个工具已经非常成熟正常使用场景下版本更新带来的收益主要是对最新设备的兼容支持而不是新功能。1.0.41 这个版本涵盖了 Android 13 之前几乎全部的特性命令行为稳定第三方脚本兼容性也好。反过来如果遇到新机型、新系统版本在adb devices里识别异常也不要迷信版本越老越稳的说法有些老版本 adb 对 Android 14 及以上设备的握手确实存在兼容问题。这个时候去官方下载最新 platform-tools或者保持 1.0.41 但确认自己的 platform-tools 构建号足够新都能解决。我的建议是日常开发固定用一个稳定的版本1.0.41 完全够用系统环境变量指向它新平台或特殊设备调试时再单独准备一个最新版用的时候指定绝对路径调用避免把默认环境搞乱。比如我把最新版解压在~/platform-tools-canary需要用到时直接~/platform-tools-canary/adb devices这样两套环境互不干扰踩过的坑也变少了。最后再多说一句adb 连接出问题时先别急着重装驱动、换工具把手机端撤销 USB 调试授权和电脑端adb kill-server这两个重启大法先做一遍很多看起来复杂的问题本质只是握手状态卡死了重启能解决其中一大半。本文还有配套的精品资源点击获取