Android Studio 新版 Logcat

一、新版核心变化（和旧版区别）

1. 采用 字段:值 键值对语法，支持精确匹配、正则匹配、反向排除、多条件组合；
2. 自动联想提示（你截图里下拉列表就是语法提示）；
3. 支持多条件空格叠加，同时生效（交集逻辑）。

基础符号规则（看懂截图里的 tag~: package~:）

表格

符号	作用	示例
字段:xxx	精确完整匹配，完全相等才命中	tag:PermissionUtils 只匹配 TAG 完全等于 PermissionUtils
字段~:xxx	正则模糊匹配 （截图里全部带 ~ 的就是这个）	tag~:Permission 匹配包含 Permission 的所有 TAG
-字段:xxx	反向排除，不显示这条日志	-tag:System 过滤掉 TAG=System 的日志
-字段~:xxx	正则排除，剔除符合正则的日志	`-tag~:System	UI` 同时过滤 System、UI 两个 TAG

二、全部内置过滤字段（日常高频）

1. package 包名过滤（最常用）

plaintext

# 只看当前调试App日志（一键过滤系统杂日志，必记）
package:mine

# 精确匹配完整包名
package:com.volvocars.adapterservice.china

# 正则匹配包名（包含某段包路径）
package~:cars.adapter

# 排除其他第三方包
package:mine -package:com.android

截图里的 package:mine、package~:com.cars.adapterservice.china 就是这个语法。

2. tag TAG 过滤（你最关心的 log.xxx）

精确匹配（完整 TAG）

plaintext

# 只看 PermissionUtils 这个TAG
tag:PermissionUtils
# 只看 DataCenterProvider
tag:DataCenterProvider

正则模糊匹配（截图里 tag~: 系列，匹配包含关键字的 TAG）

plaintext

# 所有包含 Permission 的TAG（PermissionUtils、PermissionTest 都会出来）
tag~:Permission

# 多TAG同时匹配（正则 | 分隔）
tag~:PermissionUtils|DataCenterUtils|CarService

# 匹配前缀为CarService的所有TAG
tag~:^CarService.*

# 排除指定TAG
package:mine -tag~:System|ActivityManager

截图里 tag~:PermissionUtils、tag~:CarService|CarPropertyViewModel 就是正则多 TAG 匹配。

3. level 日志等级过滤

等级：verbose / debug / info / warn / error / assert

plaintext

# 只看Error级别日志
level:error

# 只看Warn+Error
level~:warn|error

# 过滤掉Verbose调试日志
-level:verbose

截图里 level:error 就是只展示报错日志。

4. message 日志内容过滤（搜日志里打印的文字）

plaintext

# 精确匹配日志内容完整文字
message:"加载数据失败"

# 正则模糊搜索包含关键字的日志
message~:权限申请|Property变更

# 过滤掉无用打印
-message~:心跳包

5. process 进程过滤（多进程项目）

plaintext

# 匹配进程名
process:car_service
# 正则匹配多进程
process~:adapter|car

6. 其他辅助字段

• age:10m：只展示 10 分钟内的日志
• is:stacktrace：只展示崩溃堆栈日志
• line:xxx：匹配日志行内任意内容（等价于全局搜索）

三、多条件组合写法（日常开发最实用）

多个条件用空格隔开，同时满足才显示日志（交集）

示例 1：只看自己 App、Error 级别、TAG 含 CarService

plaintext

package:mine level:error tag~:CarService

示例 2：只看权限相关 TAG，过滤系统日志

plaintext

package:mine tag~:Permission

示例 3：只看 CarProperty 相关日志，排除系统打印

plaintext

package:mine tag~:CarProperty -tag~:System

示例 4：同时监控多个业务 TAG，只看 Debug 及以上

plaintext

package:mine tag~:PermissionUtils|DataCenterProvider level~:debug|info|warn|error

四、针对你截图场景的实操示例（车载项目）

你的日志 TAG：PermissionUtils、DataCenterUtils、CarService|CarPropertyViewModel

1. 只看权限模块日志

plaintext

package:mine tag~:Permission

2. 同时看权限 + 数据中心模块

plaintext

package:mine tag~:PermissionUtils|DataCenterUtils

3. 只看车辆属性相关报错

plaintext

package:mine tag~:CarService level:error

4. 过滤所有系统杂日志，只保留业务 TAG

plaintext

package:mine tag~:PermissionUtils|DataCenterUtils|CarService -tag~:android|System

五、保存常用过滤模板（不用每次重复输入）

1. 输入过滤语句；
2. 输入框左侧星号⭐按钮点击，保存为预设过滤器；
3. 下次直接下拉选择，不用重复敲语法。

六、常见踩坑 & 技巧

1. **模糊匹配必须带 ~**直接写 tag:Permission 只会匹配 TAG 完全等于Permission，不会匹配PermissionUtils；想要包含关键字必须 tag~:Permission。
2. 多 TAG 同时匹配用 | 分隔正则 tag~:A|B|C 一次性匹配多个 TAG，不用写多条过滤。
3. 快速降噪万能开头 所有过滤语句最前面加上 package:mine，直接过滤 90% 系统、第三方进程垃圾日志。
4. **想切回旧版 Logcat（怀旧）**File → Settings → Experimental → Logcat → 取消勾选 Enable new Logcat tool window，重启 AS 恢复旧版。
5. 引号处理带空格的 TAG / 内容 TAG 带空格时：tag:"My Permission Util"
6. 正则特殊字符转义 TAG 含 . | 等符号，需要反斜杠转义 tag~:CarService|CarProperty

七、最简速查口诀

1. 精确匹配：字段:完整值
2. 模糊搜 TAG / 包：字段~:关键词
3. 排除日志：-字段:值 / -字段~:关键词
4. 只看自己 App：前缀必加 package:mine
5. 多条件叠加：空格分隔多个过滤语句