简介一套面向 Android 开发者与设备维护者的 ADB 工具包集成 adb、fastboot 等官方命令行组件围绕安卓调试桥的客户端-服务器-守护进程架构可应对设备连接、文件传输、Shell 命令执行、日志采集、模拟输入以及锁屏密码清除等常见调试与解锁需求适合应用开发、刷机解锁、自动化测试与系统维护等场景。压缩包共 23 个文件以可执行程序exe、批处理脚本bat、动态链接库dll为主并附有文本说明、配置属性与镜像文件其中 exe 提供 adb、fastboot 等核心工具bat 封装常用命令组合dll 保证 Windows 运行环境整体 1.88MB轻量便携解压即可使用。已有 19038 人学习下载覆盖从入门到进阶的 Android 调试人群。工具包提供完整的 ADB 命令链与实用脚本可快速部署应用到设备、抓取 logcat 日志分析崩溃原因也能通过模拟点击滑动执行自动化测试在忘记锁屏密码时还可借助恢复模式配合指令清除用户数据是调试与应急处理的好帮手。1. adb工具包到底解决什么问题从“连不上”到“一条命令搞定”做安卓调试的人手里多少都得有一套 adb工具包。它是一套命令行工具集——把 Google 官方 platform-tools、各品牌 USB 驱动和常用脚本打进一个压缩包解压配置后就能用 adb 命令直接指挥安卓设备解锁屏幕、抓崩溃日志、截图、装应用都走这一条路。adb 全称 Android Debug Bridge中文圈管它叫调试桥工具包干的事就是把这座桥的桥墩先铺好。它的价值在适配老机器、新机型、车机、盒子驱动和授权方式各不相同工具包帮你把“缺哪个补哪个”的步骤提前做完。适合刷机爱好者、APP 测试开发、修车机和旧电视的人以及想批量管理多台安卓设备的人。下面从目录结构说起把环境、命令和踩坑点一次讲清。2. 拆开这个 adb 工具包目录结构、版本选择与运行原理拿到压缩包先别急着双击 adb.exe。我见过不少把 fastboot 当 adb 用的人设备进不了系统才想起这俩不是一回事。先花两分钟看清目录后面排错能省一半时间。2.1 platform-tools 里的角色文件adb.exe、fastboot.exe 与两个 DLL一份标准 adb 工具包解压后核心是 platform-tools 目录外加一个驱动目录和几个封装好的批处理脚本。里面的东西各管一摊文件/目录职责adb.exe调试桥主程序跑设备端命令、文件传输、日志抓取fastboot.exe刷机协议工具bootloader 阶段刷分区、解锁都靠它AdbWinApi.dllWindows 下 adb 与 USB 栈的通信层Win7 以上系统必需AdbWinUsbApi.dll老式 USB 驱动兼容层部分古董设备驱动要带上它drivers/通用 ADB 驱动或厂商驱动装“感叹号”设备时用*.bat / *.sh一键安装、抓日志、截图等日常操作的封装这里要理解一个关键区别adb 和 fastboot 不是同一个协议。adb 是 client-server-daemon 结构命令先打到电脑后台常驻的 server默认监听 5037 端口server 再通过 USB 或 TCP 连到设备里的 adbd 守护进程fastboot 则是设备在 bootloader 阶段运行的协议系统都没起来它反而能工作。所以刷机刷到一半机器变砖fastboot 还在而 adb 已经没反应了这是正常的不是工具包坏了。DLL 文件容易被忽略但缺了任何一个adb.exe 双击就会报“找不到 AdbWinApi.dll”。x86 和 x64 的 DLL 不能混用工具包里一般按 64 位主版本配好装完直接能用。如果从网上单独下 exe 而不带这两个 DLL命令会起不来这也是“工具包”和“单个 adb.exe”的本质区别。注意如果 adb 命令全部卡住或提示端口被占先怀疑 server 状态不用重装任何东西直接看第 5 章的排查步骤。2.2 版本选择与环境变量为什么 64 位版本和纯英文路径更省心工具包里的 adb 版本不是越新越好。新版本平台工具对 Android 11 以上设备的 RSA 授权处理更友好但个别老车机、老盒子的固件反而和新版不兼容fastboot 会报 unknown command。我的习惯是工具包里同时放两个版本一个主用的 64 位新版一个兼容旧设备的旧版目录分开按场景切换。Android 6 以下的设备、大厂定制安卓的车机、海信这类机顶盒旧版本往往比新版本更稳。解压位置建议直接放 C:\adb别进带空格的“Program Files”也别放中文路径。工具包里的脚本是按纯英文路径写的路径带空格或中文时批处理解析会翻车。然后配置环境变量# 在 PowerShell 里把 C:\adb 加进当前用户的 PATH [Environment]::SetEnvironmentVariable(Path, $env:Path;C:\adb, User) # 新开一个终端窗口验证 adb version adb devices逻辑说明SetEnvironmentVariable 的第三个参数传 User只改当前用户的环境变量不需要管理员权限如果传 Machine写系统级 PATH 时会被 UAC 拦住造成“明明加了却不生效”的假象。adb version 输出里能看到 build 版本号如果低于 1.0.31连新设备会反复 unauthorized直接换工具包里的新版即可。参数说明adb devices不带参数只显示序列号和状态日常排查够用想看更多信息加-l会补出设备型号、usb 端口字段。后面所有命令都用adb -s 序列号指名道姓指定设备多设备插着时不会串台。配置完 PATH 后终端里敲where adbWindows能看到解析到的路径如果指向了系统残留的旧版本把 PATH 里靠前的旧路径清掉再试。3. 第一次连接设备环境配置、授权流程与设备状态判断很多新手卡在“命令我懂设备就是连不上”。这一章走完整链路手机端打开入口电脑端装对驱动最后用 adb devices 确认设备状态。Win11 新装系统第一次插设备尤其要注意驱动系统自带的通用驱动经常被更新覆盖成错误版本后面第 5 章有专门的处理。3.1 手机端开启 USB 调试开发者选项与各品牌 ROM 的隐藏项通用入口是设置→关于手机→连点“版本号”7 次然后设置里出现开发者选项打开“USB 调试”。但各品牌 ROM 有各自的脾气MIUI 要在开发者选项里同时打开“USB 安装”否则 adb install 会报 INSTALL_FAILED_USER_RESTRICTEDOPPO、realme 部分机型需要登录账号才能打开 USB 调试开关iQOO 系在开发者选项里还有一层“USB 调试安全设置”不开的话授权弹窗被吞华为、荣耀老机型默认开“USB 调试保护”弹窗同样出不来。电视类设备比如小米电视路径是设置→关于→连续点击版本号只有部分系统版本开放 adb 端口装应用前先确认端口通不通。插数据线时手机上要选“文件传输MTP”而不是“仅充电”。这是最容易被忽略的一步——选仅充电时adbd 可能根本没被激活电脑端自然什么都看不到。开发者选项打开后建议顺手把“屏幕不休眠”也开了否则调试过程中黑屏后面授权弹窗又会被吞掉。3.2 电脑端驱动与授权从 unauthorized 到 device 的完整链路插线后观察电脑设备管理器。如果出现带黄色感叹号的设备说明驱动不对右键→更新驱动→浏览我的电脑→指向工具包的 drivers 目录勾选“包括子文件夹”强制安装。装完拔插一次数据线这一步不做的话后面 adb devices 会一直显示 offline。然后跑一遍初始化命令adb kill-server # 杀掉可能残留的旧 server保证从干净状态开始 adb start-server # 重新启动 adb server监听 5037 端口 adb devices -l # 列出设备序列号、状态、型号信息逻辑说明这三条命令是每次排错的起手式。kill-server 把后台残留的 server 清掉避免端口和指纹状态脏掉start-server 之后设备重新握手devices -l 输出的状态列是命门——unauthorized 表示手机端没确认过 RSA 指纹device 表示已授权可用offline 表示驱动或 USB 通道有问题。授权流程是首次连接时电脑端 adb server 会把本机公钥推给设备手机屏幕上弹出“允许 USB 调试吗”的对话框勾选“始终允许”并确认后设备端才保存这份指纹状态才变成 device。弹窗没出来或者勾了始终允许还是 unauthorized就是第 5 章第一个坑。另外注意授权框只在首次连接或电脑端指纹变化时才弹不是每次插线都弹。提示品牌 ROM 的授权弹窗可能藏在后台或要求屏幕保持亮屏才显示插线前先让手机保持解锁状态。4. 高频操作实战解锁、抓日志、截图与屏幕方向的命令组合连接稳定之后工具包才真正开始干活。这一章是使用频率最高的几组命令解锁、抓日志、截图、改屏幕方向。每个都配了参数说明直接抄就行。4.1 解锁的两层含义屏幕唤醒与 bootloader 解锁的分界线“adb 解锁”在圈里有两层意思。日常说的解锁是解除锁屏——自动化测试、远程调试时屏幕锁着没法操作。先亮屏再干掉锁屏界面# 点亮屏幕KEYCODE_WAKEUP 的键值是 224 adb shell input keyevent KEYCODE_WAKEUP # 亮屏后尝试直接移除锁屏界面 adb shell wm dismiss-keyguard # 部分 ROM 不吃 dismiss-keyguard退一步用菜单键模拟滑开 adb shell input keyevent 82 # 图案锁/密码锁兜底模拟手指上滑 adb shell input swipe 540 1200 540 400 200逻辑说明input keyevent 是往设备注入按键事件。KEYCODE_WAKEUP 只负责唤醒屏幕不解锁wm dismiss-keyguard 是让 Window Manager 直接取消锁屏显示干净利落但需要 adb 有足够权限keyevent 82菜单键在部分定制 ROM 的锁屏上等效于滑动解锁是低权限下的妥协方案。最后那行 input swipe 是模拟手指从坐标 540,1200 滑到 540,400耗时 200ms主要对付需要上滑解锁的锁屏。我一般先试 dismiss-keyguard不行再按顺序退化。另一层“解锁”是 bootloader 解锁刷机之前绕不开。工具包里的 fastboot.exe 就是干这个的命令是fastboot flashing unlock新机型或fastboot oem unlock老机型。执行前确认已经进了 bootloader关机后长按音量下电源并且想清楚——这一步会清空设备全部数据部分机型解锁后部分功能永久失效。注意fastboot 解锁不是 adb 命令是 fastboot 协议命令别在系统里直接敲否则只会得到 waiting for device。4.2 logcat 抓取日志过滤级别、保存文件与崩溃定位崩溃、ANR、卡顿这类问题最直接的证据在 logcat。抓日志的基本姿势是先清空旧日志再按级别或按进程过滤# 清空设备端日志缓冲区保证接下来抓到的是新日志 adb logcat -c # 抓全局 Warning 以上日志带线程和时间信息存到电脑 adb logcat -v threadtime *:W app_crash.log 21 # 只看崩溃核心AndroidRuntime 的 Error 级别堆栈 adb logcat -s AndroidRuntime:E -v threadtime # 按 pid 过滤pid 先通过 pidof 拿到 adb logcat --pid$(adb shell pidof com.example.app) -v threadtime逻辑说明-v threadtime控制输出格式包含线程 ID 和时间戳定位问题少很多猜测*:W是全局过滤W 以上包含 Warn 和 Error日常排查够用-s AndroidRuntime:E是 silent 模式的简写只输出指定 tag 的指定级别App 崩了几乎都会在 AndroidRuntime 里留堆栈。按 pid 过滤适合只盯某个 App 的场景配合复现操作可以快速定位崩溃类。参数说明重定向 app_crash.log 21不能省不重定向日志在终端里刷得看不清21 是把 stderr 也收进文件否则部分错误输出会漏掉。复现崩溃前先用adb shell am force-stop 包名把应用杀掉再冷启动一次堆栈信息最干净。这个场景下“关闭后台运行程序”的命令也是同一个想停掉任何后台进程am force-stop 是首选比 pm disable 温和且不需要 root。4.3 截图与屏幕方向screencap、wm 的参数清单截图和屏幕方向是测试适配时最高频的操作。截图注意用 exec-out 而不是 shell 重定向# 指定设备截图并保存到电脑当前目录二进制安全通道 adb -s 序列号 exec-out screencap -p current_screen.png # 锁定横屏参数范围 03见下表 adb shell settings put system user_rotation 1 # 恢复竖屏 adb shell settings put system user_rotation 0 # 临时改分辨率和密度模拟不同屏幕参数 adb shell wm size 1080x1920 adb shell wm density 440 # 测试完还原 adb shell wm size reset adb shell wm density reset逻辑说明exec-out 走的是二进制输出通道不会有终端转码把 PNG 内容破坏如果用adb shell screencap -p a.png这种写法Windows 终端会把部分字节当控制字符吞掉出来的图经常损坏。wm size 和 wm density 是全局修改改完所有应用都会受影响测完必须用 reset 还原否则后续测试数据全被污染。多设备场景下-s 参数必须放在 adb 后面、子命令前面顺序错了会报错。user_rotation 参数表值屏幕方向0竖屏默认1横屏顺时针转 90°2反向竖屏倒过来3反向横屏5. 避坑与常见问题授权异常、驱动冲突与车机盒子的特殊处理这一章是实战里最值钱的。以下每一条都是我和同行用实际设备换回来的血泪经验按“现象→原因→解决”写直接对照处理。5.1 unauthorized 反复出现RSA 指纹串台与授权弹窗被吞现象adb devices 里设备一直显示 unauthorized手机端死活不弹“允许 USB 调试吗”的对话框。原因两种情况最常见。一是电脑端 RSA 指纹文件损坏或被清理工具删过和设备端保存的指纹对不上二是手机 ROM 开了“USB 调试保护”或同类拦截弹窗被系统直接吞掉。还有一种隐蔽场景多台电脑轮流插同一台设备设备端记录的指纹列表满了新电脑的指纹进不去。解决先删掉电脑端指纹让 server 重新生成一份# 备份并移除本地 RSA 指纹文件Windows 默认在用户目录下 move %USERPROFILE%\.android\adbkey %USERPROFILE%\.android\adbkey.bak move %USERPROFILE%\.android\adbkey.pub %USERPROFILE%\.android\adbkey.pub.bak # 重启 adb server强制生成新密钥并重新握手 adb kill-server adb start-server adb devices逻辑说明move 做的是备份而不是直接删后悔药留着杀掉 server 重启后电脑端会生成新的密钥对手机端再次弹出授权框。如果还是不弹去开发者选项里关掉“USB 调试保护”华为荣耀系还要检查“USB 配置”是不是停在“仅充电”。多设备同时插着时弹窗容易串台建议 debug 时只插一台设备确认授权完成后再插第二台。5.2 车机和机顶盒没有开发者选项的设备怎么进 adb现象吉利车机想强制进入 adb 模式却摸不到入口海信机顶盒的 adb 开关要算码老款创维电视连续点击版本号也没反应。原因这类设备不走标准安卓 UI开发者选项入口被厂商隐藏。车机要进工程模式才有 adb 开关海信部分机顶盒的 adb 开关要用按 MAC 地址计算的密码才能打开而且算码工具必须匹配固件版本跨版本算出的密码大概率是错的。解决思路是“先开隐藏入口再走局域网连接”。车机一般在设置→系统信息里连续点软件版本号或者按工程密码进入机顶盒则是在拨号界面敲对应代码配合算码工具生成当日密码。入口打开后让设备和电脑连同一个局域网用网络 adb 连接# 局域网方式连接设备5555 是网络 adb 默认端口 adb connect 192.168.1.100:5555 # 检查连接结果 adb devices参数说明adb connect 后面跟 IP:端口端口不对会一直提示 unable to connect部分盒子把端口改成了非默认值连不上先确认盒子的实际端口而不是反复重试同一个地址。这类设备的授权逻辑和手机不一样有的根本不弹授权框首次连上后重启设备再看状态变成 device这是正常的不是故障。另外设备端 adb 开关如果每次断电都要重新打开那是固件设计如此不是你的操作问题。5.3 端口占用、驱动感叹号与熄屏断连三个高频翻车点现象 1原来正常的 adb 突然全部卡住报 cannot bind 或找不到设备。原因5037 端口被别的工具占了。最常见的是 scrcpy、各种手机助手或者上一个没退干净的 adb server。解决先杀后查按进程 ID 处理adb kill-server netstat -ano | findstr :5037 # 找出占用 5037 的 PID taskkill /PID 12345 /F # 强杀对应进程PID 以 netstat 输出为准 adb start-server逻辑说明netstat 输出里最后一列就是进程 IDtaskkill 前先确认进程名别误杀系统进程。杀完再启动 server问题解除。这套流程对多数“adb 突然不听话”都有效先怀疑端口别急着重装驱动。现象 2设备管理器里出现带黄色感叹号的 ADB Interfaceadb devices 时有时无。原因Windows 更新或驱动卸载后系统装上了错误的 WinUSB 驱动Win11 上尤其频繁。解决右键设备→更新驱动→浏览我的电脑→指向工具包 drivers 目录勾选“包括子文件夹”强制重装。装完拔插数据线状态基本就稳了。别用设备管理器里的“自动搜索”它只会再次装回同一个错误驱动。现象 3手机放一会儿设备就变成 offline充电也连不回。原因息屏后进入 USB 休眠或者系统省电策略把 adb 通道挂起了。解决开发者选项里打开“屏幕不休眠”或“保持唤醒”部分 ROM 还要到电池优化里把 USB 调试相关项设为“不限制”。测试挂机过夜的场景这一步不做第二天起来设备大概率已经是 offline。6. 进阶把常用操作写成批处理脚本让 adb 变成顺手工具6.1 一个批处理把日常操作串起来高频操作单独敲没问题但测试前总得重复解锁、清日志、截图每回敲一遍太亏。我习惯写一个 routine.bat把环境准备串成一条命令echo off rem 用法routine.bat 设备序列号多设备时靠 -s 指定 set DEV-s %1 adb %DEV% shell input keyevent KEYCODE_WAKEUP adb %DEV% shell wm dismiss-keyguard adb %DEV% exec-out screencap -p %date:~0,4%%date:~5,2%%date:~8,2%_screen.png adb %DEV% logcat -c echo 环境就绪逻辑说明%1 是传入的设备序列号-s 参数保证多设备时不串台%date:~0,4% 之类是从系统日期里截取年、月、日拼进文件名避免截图互相覆盖整段脚本把亮屏、解锁、截图、清日志串在一起测试开始前一条命令就走完环境准备。6.2 两个 settings put 实战锁定方向与 WiFi 感叹号settings put 是往系统全局配置里写值适合做持久化修改效果有时候挺玄学但这两个是我验证过多次的# 关闭网络连接检测消除 WiFi 感叹号部分系统重启后恢复 adb shell settings put global captive_portal_detection_enabled 0 # 或者把检测服务器换成可达地址也是常见解法 adb shell settings put global captive_portal_server connectivitycheck.gstatic.com参数说明captive_portal_detection_enabled 为 0 表示关闭检测captive_portal_server 是换检测源。这类修改写进系统数据库重启一般还在少数 ROM 会重置跑完看实际效果就行。用来消除感叹号只是其中一种用法同样的机制还可以调屏幕超时、默认输入法这类全局配置。从那以后我每次连新设备都强制走一遍先看设备管理器里驱动有没有感叹号再 adb devices 确认状态最后抓一段 logcat 验证通道。这套流程帮我避开了八成以上的翻车。这套 adb 工具包我已经整理好直接下载解压就能用。希望帮到你。本文还有配套的精品资源点击获取