Android Logcat 高效调试指南

工具概览

Logcat 是 Android SDK 提供的命令行日志工具，支持灵活过滤、格式定制和实时监控，官方文档详见 Android Developer。

基础用法

命令格式

[adb] logcat [<option>] ... [<filter-spec>] ...  

• 执行方式
  1. 直接调用（通过ADB守护进程）：

     adb logcat -v threadtime  
     

  2. 进入Shell环境执行：

     adb shell logcat -v threadtime  
     

高效抓取指南

1. 完整日志捕获（推荐）

adb logcat -v threadtime > main_log.txt  

优势：

• 包含 PID（进程ID）、TID（线程ID）、TAG（日志标签）、时间戳 等完整元数据
• 适用于问题回溯与分析

2. 精准过滤日志

通过 <filter-spec> 按 TAG + 优先级 过滤：

adb logcat -v threadtime ActivityManager:D *:S  

参数解析：

• ActivityManager:D：仅输出 ActivityManager TAG 的 DEBUG 及以上级别日志
• *:S：全局静默其他 TAG（:S 表示 SILENT 级别，即不输出）

优先级层级（从低到高）：
VERBOSE (V) < DEBUG (D) < INFO (I) < WARN (W) < ERROR (E) < FATAL (F) < SILENT (S)

高级技巧

• 实时滚动监控：

  adb logcat -v threadtime | grep "CriticalTag"  
  

• 清空日志缓冲区：

  adb logcat -c  
  

• 多条件组合过滤：

  adb logcat -v threadtime Tag1:I Tag2:W *:S