如何通过adb查看手机日志

通过 ADB 查看手机日志的实用指南

一 准备工作

• 在手机上开启开发者选项与USB 调试：进入设置 > 关于手机，连续点击版本号 7 次激活开发者选项；返回设置中开启USB 调试。
• 在电脑安装 Android SDK Platform-Tools，确保命令行可运行 adb。
• 用数据线连接手机与电脑，命令行执行 adb devices，确认设备已授权并处于 device 状态。

二 基础查看与导出

• 实时查看全部日志：

  adb logcat
  

• 带时间戳查看（更易定位问题）：

  adb logcat -v time
  

• 仅输出当前缓存日志并退出（不阻塞）：

  adb logcat -d
  

• 导出到电脑文件（例如 Windows 路径 D:\log.txt）：

  adb logcat -v time > D:\log.txt
  

  停止抓取按 Ctrl + C。

三 高效过滤与定位

• 按优先级过滤
  优先级从低到高：V(Verbose)、D(Debug)、I(Info)、W(Warning)、E(Error)、F(Fatal)、S(Silent)。
  • 只看错误及以上：

    adb logcat *:E
    

  • 只看警告及以上：

    adb logcat *:W
    

• 按 tag 与级别过滤（白名单方式）
  只显示 ActivityManager 的 Info 及以上，以及 MyApp 的 Debug 及以上，屏蔽其他：

  adb logcat ActivityManager:I MyApp:D *:S
  

  在部分 shell（如 macOS）中需加引号：

  adb logcat "ActivityManager:I MyApp:D *:S"
  

• 按进程 PID 过滤
  先获取进程号（例如包名为 com.example.myapp）：

  adb shell pidof com.example.myapp
  

  再跟踪该进程：

  adb logcat --pid=<PID>
  

• 使用 grep 做关键字过滤（适合快速检索）

  adb logcat | grep "MyApp"
  

  提示：grep 为 PC 端工具，Windows 可在 PowerShell 使用 Select-String 或安装 grep。

四 查看其他日志缓冲区与高级用法

• 查看备用缓冲区
  • 查看无线/电话相关日志：

    adb logcat -b radio
    

  • 查看系统事件日志：

    adb logcat -b events
    

  • 同时查看多个缓冲区：

    adb logcat -b main,radio,events
    

  • 查看崩溃日志缓冲区：

    adb logcat -b crash
    

  • 查看所有缓冲区：

    adb logcat -b all
    

• 常用维护与格式化
  • 清空日志缓存（抓取前常用）：

    adb logcat -c
    

  • 查看缓冲区大小/设置环形缓冲区大小：

    adb logcat -g
    adb logcat -G 16M
    

  • 输出到设备文件并轮替（设备端保存，便于长时间抓取）：

    adb logcat -f /data/local/tmp/log.txt -r 1024 -n 10
    

    （-r 为每 KB 轮替，-n 为保留文件个数）
  • 仅输出自某时间以来的最新若干行（便于复现后快速截取）：

    adb logcat -t '01-26 20:52:41.820'
    

  • 以二进制形式输出（供后续工具解析）：

    adb logcat -B
    

  • 显示统计信息（定位日志“刷屏”来源）：

    adb logcat -S
    

  说明：部分选项受系统版本与权限限制，必要时请使用 root 或系统级权限。

五 常见问题与实用建议

• 设备未授权或离线：在手机上确认允许 USB 调试，重新插拔数据线，再次执行 adb devices。
• 过滤表达式不生效：在 macOS/Linux 等 shell 中给含 * 的表达式加引号；优先使用白名单过滤（如 *:S）。
• 日志太多难以定位：抓取前先 adb logcat -c 清屏；优先用 tag:priority 精确过滤，必要时结合 grep/正则。
• 只想看崩溃信息：直接查看 crash 缓冲区或提高过滤级别到 E。
• 长时间抓取：建议输出到文件（PC 端或设备端），并使用 -r/-n 轮替，避免单个文件过大。