ADB 入门指南：安装与常用命令速查手册

在日常开发或设备调试中，ADB（Android Debug Bridge）是最常用的工具之一。无论是连接手机、电视盒子，还是安装应用、抓取日志，掌握 ADB 都能极大提升效率。

本文将从安装到常用命令，为你整理一份可直接收藏的 ADB 速查手册。

一、安装 ADB

ADB 包含在 Android SDK Platform Tools 中，根据你的操作系统选择对应安装方式。

Windows（MSYS2）

bash 复制代码

pacman -S mingw-w64-x86_64-android-tools

Ubuntu / Debian

bash 复制代码

# 安装基础工具
sudo apt install android-tools-adb android-tools-fastboot

# 如需完整 SDK 工具集
sudo apt install android-sdk-platform-tools-common

macOS

bash 复制代码

brew install android-platform-tools

验证安装

bash 复制代码

adb --version

如果输出版本号，说明安装成功。

二、设备连接与管理

基础操作

命令	说明
`adb devices`	查看已连接设备列表
`adb connect <IP>:5555`	通过 WiFi 连接远程设备
`adb disconnect <IP>:5555`	断开远程设备
`adb kill-server`	停止 ADB 服务
`adb start-server`	启动 ADB 服务
`adb -s <序列号> <命令>`	指定某台设备执行命令（多设备时使用）

无线调试（Android 11+）

bash 复制代码

# 1. 先用 USB 连接设备，开启无线调试端口
adb tcpip 5555

# 2. 拔掉 USB，通过 WiFi 连接
adb connect <设备IP>:5555

# 3. 确认连接成功
adb devices

三、应用管理

bash 复制代码

# 安装
adb install <APK路径>
adb install -r <APK路径>        # 覆盖安装，保留数据
adb install -d <APK路径>        # 降级安装

# 卸载
adb uninstall <包名>
adb uninstall -k <包名>         # 卸载但保留数据
adb shell pm uninstall --user 0 <包名>   # 卸载系统应用（无需 Root）

# 查看已安装应用
adb shell pm list packages              # 全部
adb shell pm list packages -3           # 仅第三方
adb shell pm list packages -s           # 仅系统应用
adb shell pm list packages | grep <关键词>  # 筛选

# 其他
adb shell pm clear <包名>               # 清除应用数据
adb shell am start -n <包名>/<Activity> # 启动应用
adb shell am force-stop <包名>          # 强制停止

四、文件传输

bash 复制代码

adb push <本地路径> <设备路径>     # 推送文件到设备
adb pull <设备路径> <本地路径>     # 从设备拉取文件
adb shell rm <设备路径>            # 删除文件
adb shell rm -r <设备目录>         # 递归删除目录

五、日志查看

bash 复制代码

adb logcat                        # 查看全部日志
adb logcat -c                     # 清除日志缓冲区
adb logcat -s <标签>              # 按标签过滤
adb logcat *:W                    # 仅显示 Warning 及以上级别
adb logcat -d > log.txt           # 保存日志到文件
adb shell dmesg                   # 查看内核日志
adb shell logcat -b crash         # 查看崩溃日志

六、截图与录屏

bash 复制代码

# 截图
adb shell screencap /sdcard/screenshot.png          # 保存到设备
adb exec-out screencap -p > screenshot.png          # 直接保存到电脑

# 录屏
adb shell screenrecord /sdcard/demo.mp4             # 按 Ctrl+C 停止
adb shell screenrecord --time-limit 10 /sdcard/demo.mp4  # 限时录制（秒）

七、Shell 交互

bash 复制代码

adb shell                         # 进入设备 Shell
adb shell <命令>                  # 执行单条命令
adb root                          # 获取 Root 权限
adb remount                       # 重新挂载系统分区为可读写

adb reboot                        # 重启
adb reboot recovery               # 重启到 Recovery
adb reboot bootloader             # 重启到 Bootloader

八、系统信息与调试

查询设备信息

bash 复制代码

adb shell getprop ro.build.version.release   # Android 版本
adb shell getprop ro.build.version.sdk       # SDK 版本
adb shell getprop ro.product.model           # 设备型号
adb shell wm size                            # 屏幕分辨率
adb shell wm density                         # 屏幕密度
adb shell cat /proc/cpuinfo                  # CPU 信息
adb shell cat /proc/meminfo                  # 内存信息
adb shell dumpsys battery                    # 电池信息

模拟操作

bash 复制代码

adb shell input keyevent 3                   # Home 键
adb shell input keyevent 4                   # 返回键
adb shell input tap <x> <y>                  # 点击坐标
adb shell input swipe <x1> <y1> <x2> <y2> <ms>  # 滑动
adb shell input text "<文本>"                # 输入文本
adb shell dumpsys window | grep mCurrentFocus # 查看当前 Activity

九、一键安装脚本

将以下内容保存为 install_adb.sh，方便在新机器上快速部署：

bash 复制代码

#!/bin/bash
# Ubuntu
sudo apt update && sudo apt install -y android-tools-adb android-tools-fastboot

# macOS（取消注释）
# brew install android-platform-tools

echo "ADB 安装完成！"
adb --version

十、常见问题

Q：执行 adb 命令提示 command not found？

A：说明 ADB 未安装或未添加到环境变量，请检查安装步骤。

Q：adb devices 看不到设备？

A：检查 USB 调试是否开启、驱动是否安装、数据线是否支持数据传输。

Q：无线连接失败？

A：确保设备和电脑在同一局域网，关闭防火墙或开放 5555 端口。

以上就是 ADB 从安装到日常使用的完整指南。建议收藏本文，遇到需要调试设备时可以随时翻阅。

如果你有其他常用命令或实用技巧，欢迎补充交流。