首页/资讯中心/详情

查看日志的字典key word

查看日志的字典key word
📅 发布时间：2026/7/29 16:22:45

一、adb logcat -v time中的-v是什么意思？

在adb logcat命令中，-v代表 “Format”（格式），它是--format的缩写。这个参数用来控制日志输出的显示格式。

-v time的具体含义是：在输出的每一行日志前，添加“时间戳”信息（包括日期、时间、毫秒数、进程ID/线程ID和日志级别）。

如果不加-v time，默认的日志格式可能非常简短（例如只显示进程ID和日志内容）。加上-v time后，日志格式会变成类似下面这样，极大地方便了对问题发生时间的定位：

05-22 14:30:15.123 D/PowerSupply( 1205): battery voltage: 4200 mV [ 日期 ][ 时间 ][级/标签][PID/TID]: [ 日志正文 ]

常见的-v参数值还有：

  • -v threadtime：比time更详细，同时显示时间、进程 ID 和线程 ID（推荐在排查多线程问题时使用）。
  • -v raw：只输出原始的日志信息，不带任何时间、进程、标签等前缀。

二、 如何知道某个问题对应检索哪些关键字？有这样的“字典”吗？

行业内并没有一本官方发布的、一成不变的“标准字典”，因为不同的芯片厂商（如高通、联发科、展锐）和不同的驱动开发者，其打印的日志文本可能会有差异。

但是，Android 的底层架构（Linux 内核、硬件抽象层 HAL、系统服务）是相对固定的。资深开发者和测试人员之所以能精准写出这些关键字，是因为掌握了硬件模块的命名规律和系统服务的名称。

你提到的这句命令：
grep -iE "voltage|vbus|dwc3|xhci|usb|battery|healthd|power_supply"
其实是一个非常经典的**“USB 挂载/断开与电池充电/供电问题”**的排查组合。

下面为你梳理一份在 Android 开发和测试中常用的**“分类调试关键字字典”**：

三、 Android 常用调试关键字“字典”

1. 充电与电源管理（你给出的命令所属领域）

当设备出现“不充电、慢充电、充电发热、电量跳变、USB不识别”等问题时使用：

关键字对应含义/排查重点
battery电池通用日志（电量、温度、状态）。
voltage电压。检测电池电压或充电输入电压是否正常。
vbusUSB 供电总线。用于判断 USB 线是否插入、是否有 5V 供电输入。
dwc3/xhci常见的 USB 3.0 控制器驱动（DWC3 是 DesignWare Core 3 IP，非常常见）。用于排查底层 USB 握手、物理层（PHY）报错。
usbUSB 连接状态变化（Connected, Disconnected）。
power_supplyLinux 内核供电分类（Power Supply Class），记录充电器类型识别（如 USB_PD, QC, AC）。
healthd/BatteryServiceAndroid 系统中负责监控电池健康的守护进程和服务。
2. 系统死机、卡死、重启（Stability）

当设备无故重启、黑屏、APP 无响应时使用：

关键字对应含义/排查重点
ANRApplication Not Responding（应用无响应），排查主线程卡死。
FATAL/crash导致进程崩溃的严重错误。
OutOfMemory/OOM内存溢出。系统内存耗尽，可能导致进程被杀。
Watchdog看门狗。系统服务（如 SystemServer）卡死超过 60 秒会触发重启。
tombstone墓碑文件。底层 C/C++ 崩溃（Native Crash）时产生，用于定位底层的崩溃堆栈。
shutdown/reboot系统关机或重启的触发源（例如温度过高主动关机，或用户长按电源键）。
3. 无线网络与连接性（Connectivity）

当 WiFi 连不上、蓝牙打不开、移动网络没有信号时使用：

关键字对应含义/排查重点
WifiStateMachine/wpa_supplicantWiFi 状态机、WiFi 扫描、连接、密码校验过程。
Bluetooth/bt_/hci蓝牙通用协议、HCI（主机控制接口）层日志，用于排查蓝牙配对、连接失败。
RIL/RILC/telephonyRadio Interface Layer（无线电接口层），用于排查 SIM 卡识别、4G/5G 信号、拨打电话等。
dhcpIP 地址分配过程。
4. 屏幕显示与触摸（Display & Input）

当屏幕不亮、触摸没反应、画面卡顿时使用：

关键字对应含义/排查重点
SurfaceFlingerAndroid 系统的图层混色器，负责画面渲染输出。
InputReader/InputDispatcher负责读取和分发触摸事件、按键事件的核心模块。
backlight/brightness屏幕背光、亮度调节。
sf_frame_drop/choreographer掉帧、卡顿分析（Choreographer 负责控制帧率）。

四、 如何在没有“字典”的情况下，自己找到这些关键字？

如果你遇到了一个全新的硬件模块问题，不知道该过滤什么关键字，可以尝试以下三种方法：

  1. 观察文件系统/sys目录（最推荐的硬件排查法）：
    Linux 的硬件状态都会映射到系统文件中。

    • 例如，你想看电池信息，在adb shell中输入ls /sys/class/power_supply/，你会看到battery,usb等目录。
    • 你想看背光，输入ls /sys/class/backlight/。这些目录的名字，就是内核日志中最高频出现的关键字。

  2. 利用dmesg观察完整的内核启动日志：
    在设备刚开机或刚插拔 USB 时，输入adb shell dmesg（需要 root 权限）或adb logcat -b kernel。
    不加任何过滤地看几页，你会直接看到负责该硬件的驱动（Driver）在控制台上打印的标识（如[ 12.345678] msm_otg ...），那个msm_otg就是你要找的关键字。

  3. 使用dumpsys命令反查系统服务：
    如果你想排查某个系统功能，可以运行adb shell dumpsys -l，它会列出当前系统运行的所有服务（如window,power,wifi）。这些服务的名称，直接可以用作 logcat 的过滤标签（Tag）。