Windows 系统下 ADB (Android Debug Bridge) 全面安装与配置指南
Windows 系统下 ADB (Android Debug Bridge) 全面安装与配置指南
本指南专为 Windows 用户设计,涵盖从环境搭建、基础配置、进阶使用到常见问题排查的全流程。适用于 Windows 10/11 及最新环境。
在 Windows 系统下配置 ADB (Android Debug Bridge) 环境,最大的痛点通常不在于软件安装,而在于 USB 驱动程序 的配置。与 macOS/Linux 不同,Windows 需要为不同的手机品牌安装特定的驱动才能识别设备。
以下是针对 Windows 10/11 的 最新版 全面指南,涵盖安装、驱动配置、环境变量设置、故障排查及自动化技巧。
ADB (Android Debug Bridge) 是 Android 开发与调试的核心命令行工具。在 Windows 上,最推荐的方式是手动下载官方 Platform-Tools 并配置环境变量,或者使用一键安装脚本解决驱动问题。本指南将指导您完成安装、验证、设备连接、常用命令实战(安装 APK、日志抓取、文件传输),并深入解析“驱动未识别”、“设备未授权”、“ADB 无响应”等高频陷阱,最后提供权威学习资源。
ADB 是一个包含三个组件的客户端 - 服务器程序:
logcat)。push/pull)。screencap)、录屏 (screenrecord)。fastboot 工具进行系统刷写。Windows 下有两种主流安装方式:手动安装(推荐,可控性强) 和 一键脚本安装(适合新手)。
此方法最干净,无捆绑软件,方便后续更新。
最轻量,无需安装软件
.zip 压缩包(例如 platform-tools-latest-windows.zip)。C:\android-sdk\platform-tools。 C:\Users\你的名字\Downloads 这种长路径或包含中文用户名的路径,极易出错。C:\Program Files 或桌面,以免权限问题或路径过长。adb.exe, fastboot.exe, AdbWinApi.dll 等文件。为了让您在任意目录下都能使用 adb 命令,需将其添加到系统 PATH。
Win + S 搜索 “编辑系统环境变量” 并打开。Path 的变量,选中后点击 “编辑”。C:\android-sdk\platform-tools。adb version
Android Debug Bridge version 1.0.41),则安装成功。如果你习惯命令行操作,这是最干净、易更新的方法。
以管理员身份打开 PowerShell,安装 Chocolatey (如果已安装可跳过):
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
安装 ADB:
choco install android-sdk-platform-tools -y
Choco 会自动将 ADB 添加到系统环境变量 Path 中,无需手动配置。
(或者使用 Scoop: scoop install adb)
如果您担心驱动安装麻烦,可以使用社区维护的开源脚本,它会自动安装 ADB 并配置通用驱动。
Latest-adb-fastboot-installer-for-windowsY 确认安装,脚本会自动处理驱动签名和环境变量。这是官方标准方式,适合需要完整 SDK 的用户。
C:\Users\<你的用户名>\AppData\Local\Android\Sdk\platform-tools。在 Windows 上,即使 ADB 安装成功,如果缺少驱动,adb devices 也会显示为空或 unauthorized。
Windows 与 macOS 不同,往往需要额外的 USB 驱动才能识别手机。
大多数现代手机连接后,Windows Update 会自动拉取驱动。
如果设备管理器中显示黄色感叹号或 “Android” 未知设备:
C:\Users\<用户名>\AppData\Local\Android\Sdk\extras\google\usb_drivergoogle_usb_driver 文件夹。android_winusb.inf 文件。Android Device 或 ADB Interface。Unknown Device: C:\android-sdk\platform-tools (或者 Google USB Driver 目录)。在 CMD 中输入:
adb devices
List of devices attached
XM12345678 device
device。| 功能 | 命令示例 (CMD/PowerShell) | 说明 |
|---|---|---|
| 查看设备 | adb devices | 列出所有连接的设备 |
| 安装应用 | adb install app.apk | 安装 APK 到手机 |
| 覆盖安装 | adb install -r app.apk | 保留数据覆盖安装 |
| 卸载应用 | adb uninstall com.package.name | 卸载指定包名的应用 |
| 推送文件 | adb push local.txt /sdcard/remote.txt | PC -> 手机 |
| 拉取文件 | adb pull /sdcard/photo.jpg . | 手机 -> PC (当前目录) |
| 进入 Shell | adb shell | 进入设备命令行 (输入 exit 退出) |
| 查看日志 | adb logcat | 实时打印设备日志 (Ctrl+C 停止) |
| 过滤日志 | adb logcat -s TAG | 只看特定 Tag 的日志 |
| 截图 | adb shell screencap -p /sdcard/screen.png``adb pull /sdcard/screen.png | 截取屏幕并拉到电脑 |
| 录屏 | adb shell screenrecord --time-limit 10 video.mp4 | 录制 10 秒视频 |
| 重启设备 | adb reboot | 重启手机 |
| 重启到 Bootloader | adb reboot bootloader | 进入 Fastboot 模式 |
| 端口转发 | adb forward tcp:8080 tcp:8080 | 将设备端口映射到本地 |
| 无线调试 | adb tcpip 5555``adb connect 192.168.1.5:5555 | 开启 Wi-Fi 调试模式 (需先有线连接一次) |
unauthorizedadb devices 显示 xxxxxx unauthorized。Google USB Driver 或手机厂商驱动。adb 不是内部或外部命令Path 中路径是否正确,确保没有拼写错误。cd C:\android-sdk\platform-tools 然后运行 adb.exe devices。ADB server didn't ACK 或 failed to start daemon。adb kill-server
adb start-server
adb push 到系统目录失败。/sdcard/ 或 /data/local/tmp/。修改系统文件需要 Root 权限 (adb root 仅限工程机)。-s 参数指定序列号。adb -s R58M123456Z install app.apk
adb devices 显示 <no permissions> 或无法识别adb kill-server 然后 adb start-server。error: cannot connect to daemon 或乱码。C:\adb\platform-tools)不包含中文,也不包含空格。adb.exe,并常驻后台占用端口 5037。adb.exe 或 tadb.exe 的进程。adb 路径是你刚刚配置的那个(输入 where adb 查看当前调用的是哪个路径)。adb pair 192.168.1.5:37829
(输入手机显示的6位配对码)adb connect 192.168.1.5:5555
adb.exe 通过专用/公用网络。fastboot devices 无反应。较新版本的 ADB 支持自动补全。在 PowerShell 中,你可以尝试:
# 如果使用的是较新版 platform-tools,通常自带补全脚本
# 如果没有,可以手动加载 (假设在 C:\adb\platform-tools)
& "C:\adb\platform-tools\completion\adb_completion.ps1"
(注:Windows 下的补全支持不如 Linux/macOS 完善,但部分新版本已改善)
在 PowerShell 配置文件 ($PROFILE) 中添加快捷指令:
notepad $PROFILE (如果文件不存在,先运行 New-Item -Type File -Path $PROFILE -Force)。function adbi { adb install -r $args }
function adbl { adb logcat }
function adbs { adb shell }
function reboots { adb reboot bootloader }
function screencap { adb shell screencap -p /sdcard/screen.png; adb pull /sdcard/screen.png .; adb shell rm /sdcard/screen.png }
adbi app.apk 等简写。对于重复性操作,可以编写 .bat 文件。例如一键重启并进入 Recovery:
@echo off
echo Rebooting to Recovery...
adb reboot recovery
pause
:: 截图并自动拉到电脑当前目录
adb shell screencap -p /sdcard/screen.png && adb pull /sdcard/screen.png . && adb shell rm /sdcard/screen.png
:: 录屏 (最长 180 秒,按 Ctrl+C 停止)
adb shell screenrecord /sdcard/demo.mp4
adb pull /sdcard/demo.mp4 .
adb, windows 在 Windows 上配置 ADB 的核心难点通常在于驱动程序和环境变量。只要遵循“官方下载、短路径解压、正确配置 Path、安装合适驱动”的原则,就能避开 90% 的坑。掌握 ADB 后,您将能高效地进行应用调试、数据备份甚至系统维护。祝使用顺利!
通过以上步骤,你可以在 Windows 上建立一个稳定、专业的 ADB 开发环境。记住,驱动是 Windows 下最关键的一环,遇到问题优先检查设备管理器和驱动签名。