在 Android 开发与测试的日常工作中，快速诊断和解决应用崩溃 (Crash)、无响应 (ANR) 和性能卡顿 (Jank) 是保障应用质量的关键。Android Debug Bridge (ADB) 提供了强大的命令行工具集，能够帮助我们深入系统底层，获取所需的所有诊断数据。
本文将为您全面梳理最常用、最核心的 ADB 诊断命令行工具，助您成为一名高效的故障排查专家。
一、 核心诊断命令：系统快照与错误记录
这些命令用于获取设备某一时刻的全局状态或关键错误记录。
1. 抓取全面的系统诊断报告：adb bugreport
adb bugreport 是最强大的诊断工具，它生成一个关于设备当前状态的全面的、打包的（.zip 格式）系统快照。
| 命令 | 作用 | 备注 |
|---|---|---|
adb bugreport |
生成包含所有诊断信息的 .zip 文件。 |
适用于分析复杂问题、系统级错误，或需提交给平台开发者时。 |
adb bugreport <文件名>.zip |
指定导出的文件名。 | 报告内容包括：完整的 Logcat 历史、ANR/Crash 堆栈、所有 dumpsys 信息等。 |
2. 提取崩溃和 ANR 记录：adb shell dumpsys dropbox
dropbox 服务相当于系统的"黑匣子"，专门收集系统运行过程中的关键错误摘要。
| 命令 | 作用 | 备注 |
|---|---|---|
adb shell dumpsys dropbox --print |
打印所有 dropbox 记录的详细内容。 |
快速检查是否有最近的系统级或应用级崩溃/ANR 记录。 |
adb shell dumpsys dropbox --print > crash.txt |
将所有记录重定向输出到本地 crash.txt 文件。 |
方便离线分析。 |
3. 提取 ANR 堆栈文件
ANR 发生后，系统将所有线程堆栈记录在 traces.txt 中，这是分析 ANR 的核心。
| 命令 | 作用 | 备注 |
|---|---|---|
cat /data/anr/traces.txt |
读取 ANR 发生时的详细堆栈信息。 | ⚠️ 通常需要 Root 权限 (adb root 或 su) 才能访问 /data/anr/ 目录。 |
cat /data/anr/traces.txt > /mnt/sdcard/tt.txt |
在设备内部将受保护的 traces.txt 复制到用户存储区。 |
复制后，可使用 adb pull 导出到电脑。 |
二、 实时日志与基础性能分析
这些是日常调试和性能监控最频繁使用的命令。
1. Logcat 日志操作
| 命令 | 作用 | 备注 |
|---|---|---|
adb logcat |
实时打印设备所有日志。 | 可通过 tag 和 level（如 *:E 只看错误）进行过滤。 |
adb logcat -c |
清除设备上当前的日志缓冲区。 | 建议在测试前执行，以确保日志干净、聚焦。 |
adb logcat -d > log.txt |
将设备上当前缓存的所有日志导出到本地文件。 | -d (dump) 参数用于导出当前缓存，而非实时监听。 |
2. CPU 与内存监控
| 命令 | 作用 | 关注问题 |
|---|---|---|
adb shell ps -t / adb shell top -m 10 |
实时查看进程的 CPU、内存占用情况。 | 性能监控，快速定位资源消耗高的进程。 |
adb shell dumpsys meminfo [package_name] |
获取特定应用的详细内存使用情况（Java Heap, Native Heap 等）。 | 内存泄漏、OOM（Out of Memory）分析的核心工具。 |
adb shell dumpsys cpuinfo |
获取设备整体和各个进程的 CPU 使用率。 | 诊断后台过度使用 CPU 导致的耗电或发热问题。 |
三、 性能与卡顿（Jank）分析
专门用于分析应用启动速度和 UI 流畅度的命令。
| 命令 | 作用 | 备注 |
|---|---|---|
adb shell dumpsys gfxinfo [package_name] |
抓取应用的图形渲染性能数据。 | 包含丢帧 (Jank) 统计和渲染时间线，用于分析 UI 卡顿问题。 |
adb shell am crash [package_name] |
强制让目标应用崩溃。 | 用于测试崩溃报告系统的稳定性和流程。 |
adb shell am start -W [package_name]/[activity_name] |
启动指定的 Activity 并等待初始化完成，同时打印启动耗时。 | 用于量化分析应用启动速度（Total Time, Wait Time）。 |
四、 深入系统诊断（dumpsys 子集）
dumpsys 可以针对不同的系统服务进行深入诊断。
| 命令 | 关注领域 | 作用 |
|---|---|---|
adb shell dumpsys activity |
Activity Manager (AMS) | 获取当前运行的 Activity 栈、后台进程列表等，用于分析应用生命周期和任务管理问题。 |
adb shell dumpsys battery |
电池状态 | 获取设备的电池和充电状态。 |
adb shell dumpsys power |
电源管理 (PMS) | 获取唤醒锁 (Wake Locks) 的持有情况，用于分析设备无法休眠导致的持续耗电问题。 |
adb shell dumpsys window windows |
窗口管理 (WMS) | 获取当前屏幕上可见的窗口列表、层级和焦点情况，用于分析屏幕显示或输入事件问题。 |
五、 文件系统操作（导出/导入文件）
这些命令是确保诊断文件能够顺利在设备和电脑间传输的基础。
| 命令 | 作用 | 示例 |
|---|---|---|
adb pull [remote_path] [local_path] |
从设备拉取文件到电脑。 | adb pull /sdcard/tt.txt . （将文件拉取到电脑当前目录）。 |
adb push [local_path] [remote_path] |
从电脑推送文件到设备。 | 通常用于推送测试用例或工具。 |
实际分析流程
在实际的故障排查中，开发者通常遵循以下高效流程：
-
准备阶段： 执行
adb logcat -c清除旧日志，确保日志的清洁度。 -
复现问题： 在设备上准确重现崩溃、ANR 或卡顿的现象。
-
抓取证据：
- 一般问题： 立即执行
adb logcat -d > log.txt抓取当前的日志缓冲区。 - 严重复杂问题： 立即执行
adb bugreport抓取最全面的系统报告。 - ANR 问题： 如果有权限，则导出
/data/anr/traces.txt文件进行线程分析。
- 一般问题： 立即执行
掌握并熟练运用这些 ADB 诊断命令，将极大地提升您在 Android 故障排查和性能优化的效率。