做Android开发、手机调试、自动化测试的小伙伴,一定绕不开 ADB 工具。它是安卓设备调试的核心利器,不管是日常装包、抓日志、传文件,还是排查设备异常、调试应用BUG,都离不开它。
很多新手只会零散用几个命令,遇到报错就手足无措。今天这篇博文,零基础讲透ADB核心用法,整理全网最高频、最实用的ADB命令,附详细释义、实操示例和避坑技巧,收藏这一篇就够!
一、什么是ADB?
ADB 全称 Android Debug Bridge(安卓调试桥),是谷歌提供的命令行调试工具,集成在 Android SDK 中。
它可以在电脑端与 Android 设备(真机/模拟器)建立通信,实现设备控制、应用管理、文件传输、日志抓取、系统调试等一系列操作,是安卓开发和设备调试的必备工具。
简单理解:ADB就是电脑操控安卓手机的“万能遥控器”。
二、前期准备:环境搭建与设备连接
1. 环境配置
1. 下载安装 Android SDK Platform-Tools,获取 adb 程序;
2. 将工具目录配置到电脑系统环境变量,确保任意终端可调用;
3. 终端输入adb version,输出版本号即配置成功。
2. 设备连接方式
方式1:USB有线连接(最稳定)
1. 手机开启「开发者选项」+「USB调试」;
2. 数据线连接电脑,选择「文件传输模式」;
3. 终端输入 adb devices,出现设备ID即连接成功。
方式2:无线WiFi连接(无需数据线)
1. 手机和电脑连接同一WiFi;
2. 查看手机IP地址(设置-关于手机);
3. 执行连接命令:adb connect 设备IP:5555(5555为默认端口);
4. 再次执行 adb devices 校验设备。
常用排查命令
– adb disconnect:断开所有设备连接
– adb kill-server:重启ADB服务(连接异常必用)
– adb start-server:启动ADB服务
三、核心高频ADB命令(分类整理,直接复用)
所有命令均经过实操验证,分为设备管理、应用管理、文件传输、日志调试、系统操作五大核心模块,日常工作全覆盖。
1. 设备管理命令(基础必备)
用于查看设备、管理设备状态、解决多设备冲突
adb devices:查看当前已连接的所有安卓设备/模拟器
adb reboot:重启设备
adb reboot bootloader:重启进入刷机模式(Fastboot)
adb reboot recovery:重启进入恢复模式
多设备冲突解决:电脑连接多台设备时,所有命令需加
-s 设备ID指定设备,示例:adb -s 123456 reboot
2. 应用管理命令(开发最常用)
覆盖安装、卸载、查包名、清缓存、启停APP全操作
安装APP
adb install 本地APK路径:普通安装APK
常用参数进阶:
– adb install -r APK路径:覆盖安装,保留APP数据(更新版本必备)
– adb install -d APK路径:允许版本降级安装
– adb install -g APK路径:安装时自动授予所有运行权限
卸载APP
adb uninstall 应用包名:彻底卸载应用
adb uninstall -k 应用包名:卸载应用,保留数据和缓存
查询应用包名
adb shell pm list packages:列出设备所有应用包名
adb shell pm list packages -3:只列出第三方安装应用(过滤系统应用)
adb shell pm list packages 关键词:模糊搜索指定应用包名
应用启停与数据清理
adb shell pm clear 应用包名:清空APP缓存和数据(相当于重装APP)
adb shell am start 应用包名:启动指定APP
adb shell am force-stop 应用包名:强制关闭指定APP
查看当前前台应用
Windows:adb shell dumpsys window | findstr mCurrentFocus
Mac/Linux:adb shell dumpsys window | grep mCurrentFocus
3. 文件传输命令(电脑↔手机互传)
无需数据线弹窗,静默传输文件,适合批量操作
adb push 本地文件路径 设备路径:将电脑文件上传到手机
示例:adb push test.txt /sdcard/(将本地txt文件传到手机根目录)
adb pull 设备路径 本地保存路径:将手机文件下载到电脑
示例:adb pull /sdcard/log.txt ./(将手机日志文件下载到当前电脑目录)
adb shell:进入手机终端,可直接操作手机文件(ls/rm/cd等命令通用)
4. 日志抓取命令(排查BUG神器)
开发调试、崩溃排查、ANR问题定位必备,精准过滤无效日志
adb logcat:实时查看设备所有系统日志
adb logcat -c:清空历史日志,方便精准抓取最新问题
adb logcat *:E:只查看Error错误日志(排查崩溃核心命令)
adb logcat -v time:日志展示时间戳,精准定位问题发生时间
adb logcat -d > log.txt:导出全部日志到本地txt文件
adb logcat -s 标签名:过滤指定TAG的日志,减少冗余信息
5. 系统常用操作命令
adb shell screencap -p /sdcard/screen.png:设备截图保存到手机
adb shell screenrecord /sdcard/demo.mp4:屏幕录制(默认3分钟,Ctrl+C结束录制)
adb bugreport:导出设备完整诊断报告,包含系统状态、服务日志,用于排查复杂疑难问题
四、高频报错避坑指南
1. 设备离线/找不到设备
解决:关闭重启USB调试、更换数据线、执行 adb kill-server 重启服务,重新连接设备。
2. 多设备连接报错
解决:用 adb devices 查看设备ID,通过 adb -s 设备ID 指定操作设备。
3. APK安装失败
常见原因:安装包损坏、版本不兼容、权限不足、应用已存在;
解决:加 -r 覆盖安装、重新下载安装包、开启设备安装未知应用权限。
4. 无线连接失败
解决:确保电脑手机同WiFi、端口未被占用,执行 adb disconnect清空旧连接重试。
五、写在最后
ADB 看似是简单的命令行工具,但却是安卓开发、测试、设备调试的核心基础技能。熟练掌握以上高频命令,能极大提升调试效率,告别繁琐的手动操作,快速定位BUG、完成设备管控。
建议大家收藏本文,日常开发随时查阅,多实操几次就能熟练掌握!后续会持续更新ADB进阶用法、自动化调试技巧~
码字不易,欢迎点赞收藏,评论区交流ADB调试踩坑经验!