工具用的顺手吗?
你的反馈能帮助我们做得更好
提供Android调试桥常用命令速查,涵盖设备连接、应用管理等指令。
所收录的ADB和Android Shell命令参考,不连接或操作设备。需按端末/Platform-Tools版本确认帮助和权限;backup/restore是旧命令,不保证当前可用。数据删除、系统设置和分区操作会改变设备状态。 参考来源
列出当前已连接的全部 Android 设备及其状态。
adb devices [-l]adb devices -l通过 TCP/IP 方式连接到指定设备(需先开启网络调试)。
adb connect <host>[:port]adb connect 192.168.1.20:5555断开指定的 TCP/IP 设备连接,省略地址则断开全部。
adb disconnect [host[:port]]adb disconnect 192.168.1.20:5555Android 11+ 无线调试配对,用于首次建立可信连接。
adb pair <host>:<port>adb pair 192.168.1.20:37123将设备的 adb 切换为 TCP/IP 监听模式,便于后续无线连接。
adb tcpip <port>adb tcpip 5555将 adb 切换回 USB 监听模式,关闭网络调试。
adb usbadb usb强制结束本地 adb server 进程,常用于连接异常时重置。
adb kill-serveradb kill-server启动本地 adb server 进程,多数命令会自动触发。
adb start-serveradb start-server在多设备场景下通过序列号指定目标设备执行命令。
adb -s <serial> <command>adb -s emulator-5554 shell pm list packages阻塞当前命令,直到至少有一台设备连接到 adb。
adb wait-for-device [next-command]adb wait-for-device shell getprop ro.product.model查看本机 adb 客户端的版本号与协议版本。
adb versionadb version获取设备当前状态,如 device、bootloader、offline。
adb get-stateadb get-state查询当前设备的序列号。
adb get-serialnoadb get-serialno读取 Android 系统属性,可获取型号、版本、SDK 等信息。
adb shell getprop [name]adb shell getprop ro.build.version.release查看电池电量、温度、是否充电等详细状态。
adb shell dumpsys batteryadb shell dumpsys battery查看进程内存占用,可定位内存泄漏。
adb shell dumpsys meminfo [package|pid]adb shell dumpsys meminfo com.android.chrome查看或修改设备屏幕分辨率。
adb shell wm size [WxH|reset]adb shell wm size 1080x1920查看或修改屏幕像素密度(dpi)。
adb shell wm density [dpi|reset]adb shell wm density 320向设备安装 APK,支持升级、降级、保留数据等选项。
adb install [-r|-t|-d|-g] <apk>adb install -r app-release.apk一次安装多个 APK,常用于 Split APK / AAB。
adb install-multiple [选项] <apk...>adb install-multiple base.apk config.armeabi_v7a.apk卸载指定包名的应用。
adb uninstall [-k] <package>adb uninstall com.example.app列出设备上的所有应用包名。
adb shell pm list packages [-3|-s|-f]adb shell pm list packages -3获取指定包名应用的 APK 安装路径。
adb shell pm path <package>adb shell pm path com.android.chrome清除应用的全部数据与缓存,相当于卸载重装。
adb shell pm clear <package>adb shell pm clear com.example.app为当前用户禁用指定应用,常用于停用系统应用。
adb shell pm disable-user [--user <id>] <package>adb shell pm disable-user --user 0 com.example.bloat通过 Activity Manager 启动一个 Activity。
adb shell am start [-n component|-a action]adb shell am start -n com.android.settings/.Settings强制停止指定包名的应用进程。
adb shell am force-stop <package>adb shell am force-stop com.example.app发送一个广播 Intent,常用于触发组件逻辑或测试。
adb shell am broadcast -a <action> [extras]adb shell am broadcast -a android.intent.action.BOOT_COMPLETED向应用发送伪随机事件,做压力或稳定性测试。
adb shell monkey [选项] -p <package> <count>adb shell monkey -p com.example.app -v 500把本地文件或目录上传到设备指定路径。
adb push <local> <remote>adb push ./config.json /sdcard/Download/把设备上的文件或目录拉取到本地。
adb pull <remote> [local]adb pull /sdcard/DCIM/Camera ./photos增量同步本机构建产物到设备相应目录(system/vendor/data)。
adb sync [分区]adb sync system列出设备目录下的文件与子目录。
adb shell ls [-l|-a] <path>adb shell ls -l /sdcard/删除设备上的文件或目录,请谨慎使用。
adb shell rm [-r|-f] <path>adb shell rm -rf /sdcard/Download/tmp复制设备内部的文件或目录。
adb shell cp [-r] <src> <dst>adb shell cp /sdcard/a.txt /sdcard/b.txt移动或重命名设备上的文件、目录。
adb shell mv <src> <dst>adb shell mv /sdcard/a.log /sdcard/old/a.log在设备上创建目录,可递归创建多层。
adb shell mkdir [-p] <dir>adb shell mkdir -p /sdcard/MyApp/cache查看设备的系统及应用日志,是排查问题的核心工具。
adb logcat [选项] [filterspec]adb logcat '*:E'清空设备上的所有 logcat 日志缓冲区。
adb logcat -cadb logcat -c导出当前已缓存的日志后立即退出。
adb logcat -dadb logcat -d > device.log指定日志输出格式,如 time、threadtime、long。
adb logcat -v <format>adb logcat -v threadtime生成完整的 bug report 压缩包,包含日志、dumpsys、堆栈等。
adb bugreport [path]adb bugreport ./bugreport.zip查看内核环形缓冲区的日志信息。
adb shell dmesgadb shell dmesg | tail -n 100进入设备的交互式 shell,或一次性执行指定命令。
adb shell [command]adb shell向当前输入框模拟键入文本。
adb shell input text <text>adb shell input text hello模拟按键事件,如返回、Home、音量等。
adb shell input keyevent <code>adb shell input keyevent 4在屏幕指定坐标模拟一次点击。
adb shell input tap <x> <y>adb shell input tap 500 1200模拟滑动手势,可控制时长实现长按。
adb shell input swipe <x1> <y1> <x2> <y2> [ms]adb shell input swipe 300 1000 300 200 200读取或写入系统设置(global/system/secure)。
adb shell settings [get|put] <ns> <key> [value]adb shell settings put global airplane_mode_on 1截取设备屏幕并保存为 PNG 图片。
adb shell screencap -p <path>adb shell screencap -p /sdcard/screen.png录制屏幕视频(Android 4.4+),保存为 MP4。
adb shell screenrecord [选项] <path>adb shell screenrecord --time-limit 30 /sdcard/demo.mp4无中转文件直接将截图传到本地。
adb exec-out screencap -p > <local.png>adb exec-out screencap -p > screen.png重启设备,可指定进入特殊模式。
adb reboot [bootloader|recovery|sideload]adb reboot recovery在支持的 ROM 上让 adbd 以 root 身份运行。
adb rootadb root退出 root 模式,让 adbd 回到普通用户权限。
adb unrootadb unroot将系统分区重新挂载为可读写,常配合修改系统文件。
adb remountadb remount关闭系统分区的校验,使 remount 写入生效。
adb disable-verityadb disable-verity重新开启系统分区的 dm-verity 校验。
adb enable-verityadb enable-verity通过 recovery 模式向设备刷入 OTA 或完整 zip 包。
adb sideload <package.zip>adb sideload update.zip备份设备数据为 .ab 文件(Android 6 后系统逐步弱化)。
adb backup [选项] [-f file]adb backup -all -f backup.ab将之前 adb backup 生成的 .ab 文件恢复回设备。
adb restore <file>adb restore backup.ab将本机端口转发到设备端口,常用于调试本地与设备通讯。
adb forward <local> <remote>adb forward tcp:8080 tcp:8080列出当前 adb forward 已建立的全部端口映射。
adb forward --listadb forward --list移除指定的本机端口转发规则。
adb forward --remove <local>adb forward --remove tcp:8080将设备端口反向转发到本机端口,让 App 访问本地服务。
adb reverse <remote> <local>adb reverse tcp:3000 tcp:3000查看当前设备反向端口转发列表。
adb reverse --listadb reverse --list移除指定的设备到本机的反向端口转发。
adb reverse --remove <remote>adb reverse --remove tcp:3000查看设备各网络接口的 IP、MAC、状态。
adb shell ip addradb shell ip addr show wlan0在设备端发起 ICMP 测试,判断网络连通性。
adb shell ping <host>adb shell ping -c 4 8.8.8.8列出可被 JDWP 调试器附加的 Java 进程 PID。
adb jdwpadb jdwp实时查看设备进程的 CPU、内存占用。
adb shell top [-n <times>]adb shell top -n 1快照当前设备运行中的进程列表。
adb shell ps [-A|-T]adb shell ps -A | grep com.example导出指定系统服务或全部服务的运行状态。
adb shell dumpsys [service]adb shell dumpsys activity activities设置系统属性,调试日志、调度等行为。
adb shell setprop <name> <value>adb shell setprop log.tag.MyTag VERBOSE对指定进程开启或停止 method tracing 性能采样。
adb shell am profile start|stop <process> [file]adb shell am profile start com.example /sdcard/trace.traceAndroid 7+ 提供的 activity 调试命令集,可控制睡眠、模式等。
adb shell cmd activity <subcmd>adb shell cmd activity start -n com.example/.MainActivity概览
了解工具能解决的问题、计算或处理逻辑,以及数据边界。
Android Debug Bridge(ADB)是一组从电脑端与 Android 设备或模拟器通信的命令。常见用途包括查看已连接设备、安装应用、传送文件、读取日志和在设备端执行 shell 命令。官方文档说明,ADB包含客户端、设备端守护进程和管理连接的服务端;使用者通常通过终端输入命令,并根据结果继续排查。
这张参考表按设备连接、设备信息、应用、文件、日志、Shell、截图录屏、系统、网络端口和调试性能等类别整理命令。Android Developers 的ADB 官方文档说明设备连接、目标选择、安装、文件传输和 shell 等功能;核验日期:2026-09-26。
每条记录会展示命令名称、用途说明、语法、示例,部分条目还有补充备注。尖括号中的内容通常代表需要替换的参数,例如 <serial> 是设备序列号、<path> 是路径;方括号里的参数一般表示可选项。示例中的包名、文件名、地址和端口可能需要按自己的设备环境替换。
搜索会匹配命令名、描述、语法、示例和备注;类别按钮可缩小结果范围。列表是便于查找的常见命令参考,不等于某一台设备上所有命令的完整清单。
指南
按步骤完成操作,并通过示例核对输入与结果。
先写下要完成的动作,例如检查连接、安装APK、抓取日志或复制文件。
在关键词框输入命令名或用途词,如 devices、install、logcat 或“截屏”,再按需切换命令分类。
打开匹配卡片,先读用途和语法,再看示例与备注。把 <serial>、<package>、<local> 等占位内容改成自己的实际值。
复制命令后,在电脑终端确认当前目录、目标设备和文件路径,再执行。参考表负责展示和复制文本,不会替你运行命令。
若连接多台设备,先运行 adb devices -l 查看序列号,再通过 adb -s <serial> <command> 指定目标,避免把操作发到错误设备。
排查连接时,可先用 adb devices 查看设备状态;若显示多个设备,加入 -s 参数明确目标。传文件可查找 adb push 或 adb pull,前者把电脑侧文件传到设备,后者把设备侧文件复制到电脑。日志分析可从 adb logcat 的过滤选项开始。
安装应用可参考 adb install <apk>,覆盖安装时列表示例使用 -r。运行前确认 APK 路径和设备序列号;测试包、旧版本系统或厂商设备可能还需要额外选项或不同权限。
场景
查看这项工具在不同工作与生活流程中的用法。
开发者或测试人员可以先搜索 devices,确认设备已出现且状态正常;再按包文件的实际路径查找安装语法。连接多台手机或模拟器时,序列号选择尤其重要。参考表中的命令可复制到终端后再审查,不会替代运行前的目标确认。
复现应用异常后,可查找日志相关命令,选择合适的过滤方式缩小输出;若需要把设备文件带回电脑,查看 pull 的本地与远端路径顺序。整理日志或诊断包前,应确认文件中没有不应分享的账号、令牌或个人信息。
问答
集中解答高频疑问与容易混淆的问题。
检查手机是否解锁,并查看设备上是否出现允许这台电脑进行调试的确认提示;确认来源可信后再接受并重新运行设备列表命令。Android 官方文档说明,连接时的授权确认用于限制未经认可的调试连接。
可以在已安装 Platform Tools 的终端运行 adb --help 查看当前版本的命令帮助,也可按对应任务查阅 Android Developers 的 ADB 官方文档。
可查找 adb exec-out screencap,常见示例是 adb exec-out screencap -p > screen.png。重定向方式取决于电脑终端;Windows环境也可按条目备注改用 PowerShell,或先保存到设备再通过 adb pull 取回。
须知
使用前了解适用范围、结果限制与必要提醒。
ADB参考内容不会判断命令对当前设备是否安全。像清除应用数据、删除文件、重启、修改系统设置或重新挂载分区等命令,可能导致数据丢失、服务中断或系统状态改变。执行前逐项确认目标序列号、包名、路径和参数,尤其检查带有递归或强制选项的删除命令。
USB调试或无线调试只应连接到自己有权管理的设备。无线连接时确认网络和配对对象;日志、备份文件和诊断包可能包含敏感内容,分享前先检查并遮盖。
参考条目的描述和语法可能随 Platform Tools 与 Android 系统版本变化。遇到不匹配时,以本机命令帮助和 Android Developers 官方文档为准。
推荐
查找相关工具、专题与可用的 API 能力。