在执行命令之前

有一点需要先说明：甲壳虫adb助手的命令终端作用于已经连接上的目标设备，因此所有指令前面都不需要再写 adb -s 设备序列号，直接写指令本身即可。多个设备同时在线时，先在设备列表里选定目标设备再打开终端。

另外，涉及系统分区写入的操作即使在免 Root 环境下也可能被系统拒绝，遇到权限类报错不必反复重试，先看报错文案判断属于哪一类，再决定是否换用其他方式。下面每个分组都给出了典型示例，示例中的路径与包名请替换成你自己设备上的实际值。

分组一：设备与连接

这一类命令用于确认连接状态、读取设备属性，是排查问题的起点。连接不上或指令无响应时，先跑一遍这组命令，往往能直接定位问题出在网络、授权还是端口。

指令	用途	说明与示例
`adb devices`	列出已连接设备	确认目标设备是否在线，以及状态是否为 device。若显示 unauthorized，说明授权弹窗没有被确认。
`adb connect IP:5555`	建立无线连接	例：`adb connect 192.168.1.20:5555`。端口被厂商改过时以设备实际监听值为准。
`adb disconnect`	断开无线连接	连接错设备或需要重新授权时使用，断开后重新 connect 即可。
`adb kill-server`	重启调试服务	连接异常时的万能第一步，通常与 `adb start-server` 一起执行。
`adb shell getprop ro.build.version.release`	读取系统版本	输出形如 11、12、13，判断能否使用无线配对机制的依据。
`adb shell getprop ro.product.cpu.abi`	读取 CPU 架构	输出 arm64-v8a 或 armeabi-v7a，决定要推送哪个架构的安装包。
`adb shell wm size`	查看屏幕分辨率	与 `adb shell wm density` 配合，改分辨率或 DPI 前先记录原值。

分组二：应用管理

应用管理是使用频率最高的一组命令。它既能替代界面上的卸载按钮，也能完成界面做不到的事情，比如只看第三方应用、只看某个关键字相关的包、或者在不打开应用的情况下清空其数据。

指令	用途	说明与示例
`adb shell pm list packages`	列出全部应用	加 `-3` 只列第三方应用，加 `-s` 只列系统应用，加关键字可过滤。
`adb shell pm list packages -3 -f`	带路径列出第三方应用	输出中包含安装包所在路径，可用于定位 APK 文件位置。
`adb install -r app.apk`	安装或覆盖安装	`-r` 表示替换已有版本并保留数据，`-d` 允许降级安装。
`adb install-multiple a.apk b.apk`	安装分包应用	遇到 split APK 时使用，一次性推送全部分包再安装。
`adb shell pm uninstall --user 0 包名`	卸载用户层应用	例：`adb shell pm uninstall --user 0 com.example.app`。适用于卸载不掉的预装应用。
`adb shell pm disable-user 包名`	停用应用	比卸载更保守，停用后应用不再运行，需要时可随时重新启用。
`adb shell pm enable 包名`	重新启用应用	与上一条互为逆操作，误停用后用它恢复。
`adb shell pm clear 包名`	清除应用数据	等价于界面上的清除数据，适合处理应用异常或存储占满的情况。

提示：执行卸载与停用之前，建议先用应用管理里的备份功能把安装包导出。系统框架类组件（包名以 com.android. 开头的核心项）不要卸载，具体判断方法见功能解析中的应用管理章节。

分组三：文件与屏幕

这一类命令解决「把文件拿回来」和「把画面留下来」两个需求，配合甲壳虫adb助手的文件管理与屏幕截图功能使用效率更高。

指令	用途	说明与示例
`adb pull 远程路径本地路径`	取回文件	例：`adb pull /sdcard/Download/app.apk`，把目标设备文件下载到本机。
`adb push 本地路径远程路径`	推送文件	例：`adb push config.xml /sdcard/`，把本机文件写入目标设备。
`adb shell ls -l /sdcard`	浏览目录	配合 `-a` 显示隐藏项，确认文件是否真的写在预期位置。
`adb shell screencap -p /sdcard/s.png`	截取当前屏幕	截图保存到设备，再用 pull 取回本机，效果与实用工具箱里的截图一致。
`adb shell screenrecord /sdcard/r.mp4`	录制屏幕	按 Ctrl+C 停止，时长默认上限三分钟，适合记录偶发问题。
`adb shell wm size 1080x1920`	修改分辨率	调试完务必用 `adb shell wm size reset` 还原，否则界面可能显示异常。
`adb shell wm density 320`	修改 DPI	数值越大界面元素越大。`adb shell wm density reset` 可一键还原。
`adb shell logcat -v time`	抓取日志	加 `-s 标签名` 过滤指定标签，加 `--pid=PID` 只看某个进程。

分组四：系统与性能

设备卡顿、发热、耗电异常时，这一组命令用来确认到底是谁在占资源。它们通常与进程管理页面配合使用，先在界面里找到可疑应用，再用命令做进一步确认。

指令	用途	说明与示例
`adb shell ps -A`	列出全部进程	查看进程号与所属用户，配合 grep 过滤目标包名。
`adb shell top -n 1`	查看资源占用	单次输出 CPU 与内存占用排行，快速定位占用最高的进程。
`adb shell dumpsys meminfo 包名`	查看应用内存	输出该应用的内存构成，用于判断是否存在内存泄漏。
`adb shell dumpsys battery`	查看电池状态	包含电量、温度、充电方式等信息，排查异常耗电时常用。
`adb shell am force-stop 包名`	强制停止应用	应用无响应且无法退出时使用，等效于界面上的强制停止。
`adb shell am start -n 包名/活动名`	启动指定界面	可直接跳转到被系统隐藏的设置页，例如开发者选项。
`adb shell df /data`	查看分区剩余空间	安装失败且怀疑空间不足时，用这条确认实际可用容量。

值得保存成快捷指令的六条组合

命令终端的价值在于复用。下面六条建议在甲壳虫adb助手里命名保存，之后一键执行，它们覆盖了绝大多数临时排查场景。

adb shell pm list packages -3 —— 一眼看清设备上装了哪些第三方应用；
adb shell dumpsys battery —— 快速确认电量与温度，判断是否因低电量被限制性能；
adb shell wm size —— 修改分辨率前记录原值，出问题好回滚；
adb shell ps -A | grep 关键字 —— 定位某个应用的进程号，便于后续精确操作；
adb shell df /data —— 安装大体积应用前确认剩余空间；
adb shell getprop ro.product.cpu.abi —— 选择安装包架构前先确认设备架构。

常见报错对照表

命令执行失败时，报错文案本身就是最直接的线索。下面这几类是实际使用中出现频率最高的，按表格给出的顺序处理通常一步就能解决。

报错提示	常见原因	处理顺序
`unauthorized`	授权未被确认或密钥不匹配	在目标设备上重新确认授权弹窗并勾选始终允许；必要时删除授权记录重新配对。
`device offline`	调试服务异常或连接不稳	先重启调试服务，再重新连接；仍然无效则重启目标设备的 ADB 开关。
`connection refused`	端口未监听或被拦截	确认无线调试开关处于打开状态，确认端口号填写正确，检查路由器是否拦截了该端口。
`Permission denied`	目标路径或操作受系统保护	属正常权限限制，改用免授权的替代指令；不要强行写入系统分区。
`INSTALL_FAILED_INSUFFICIENT_STORAGE`	目标设备空间不足	先用 `df /data` 确认剩余空间，清理后再重新推送安装包。
`INSTALL_PARSE_FAILED_NO_CERTIFICATES`	安装包不完整或签名异常	重新获取安装包，并核对架构是否与设备匹配。
`error: protocol fault`	调试协议版本不兼容	常见于较老的电视或盒子，改为通过 OTG 有线方式连接后重试。

如果报错不属于上面任何一类，建议回到常见问题中的安装与运行分类按现象逐项排除，同时把设备的 Android 版本一并记下，便于判断是否为系统机制变更导致。

甲壳虫adb助手命令终端常用指令速查