前言：

俗话说，工欲善其事，必先利其器。logcat是我们通过日志排查bug的重要武器之一。从某个版本开始，logcat改版了，改版之后，也许某些人觉得不太习惯，但是如果稍微学习下之后，就发现新版的logcat真的比老版本的好多太多。

也许某个人懒，不太愿意去android的官网查看官方介绍，那么本地特别适合你，本文就是对官网介绍的详细说明以及实例的演示。

android官网logcat的相关介绍。

https://developer.android.google.cn/studio/debug/logcat?hl=zh-cn

logcat界面基本介绍

首先介绍下logcat界面上的组成：

1.顶部框

名称	说明
TAB栏	一个TAB栏对应一个logcat显示框，可以配置多个
设备	当同时连接太多设备时，可以选择不同的设备显示其logcat
筛选框	对输出的logcat按照规则进行筛选，具体筛选的规则第二章来讲
配置按钮	对logcat显示的区域，位置，大小等等进行配置

2.左侧栏

名称	说明
暂停	暂停logcat的日志输出，使其保持在当前状态。这个功能很适合我们排查bug时发现了一场日志，避免后面的持续输出的日志的影响。
重启	重启logcat功能。
置底按钮	logc不断输出，使显示的log内容一直是最新的，也就是现实log内容的最底部。
往上查找	往上查找最近一次的堆栈日志。
往下查找	往下查找最近一次的堆栈日志。
分行显示	有时候一个logcat内容输出太多，默认一行展示不下就缩略了。选择多行显示时，会分成多行显示。
配置显示内容	对内容框中显示的内容进行配置
分成多块显示	底部框分成两块，分别独立显示logcat
截屏	截屏功能
录屏	录屏功能

3.搜索栏

名称	说明
搜索内容	输入搜索的内容，这里支持区分大小写，单词匹配，转义。
向上	向上查找
向下	向下查找
搜索范围选择	选择搜索的范围，比如所有类型，评论中，字符串中等等

4.内容框

名称	说明
时间	日志输出的时间，这里的时间为手机上的时间。
进程ID和线程ID	进程ID和线程ID，这里的线程ID指的是在linux虚拟机中的线程ID。
TAG	我们日志中的tag。
进程名	进程名，如果是APP应用的话一般为包名。
日志优先级	共有六种登记，分别为verbose/debug/info/warn/error/assert
日志内容	我们日志中的msg。

筛选功能

1.包名

我们可以根据包名来对log的内容进行筛选，如果我们筛选的包名是com.xt.appplugin ，则可以在筛选框输入：package:com.xt.appplugin，这样筛选出来的log就只是com.xt.appplugin这个应用输出的了。

如果当前调试的应用就是com.xt.appplugin的话，我们也可以输入：package:mine，mine代表就是当前应用，如下：

2.进程名

进程名和包名有什么区别呢？因为一个应用可以多进程，如果我们只关心其中某一个进程的日志输出，就可以使用这个功能。

为了方便读者理解，我们举例说明一下，测试代码如下：

//Activity中
findViewById(R.id.text1).setOnClickListener(v -> {
    Log.i("lxltest", "button1 press");
    Intent intent = new Intent(this, TestService.class);
    startService(intent);
});
//Service中
public class TestService extends Service {
    @Override
    public void onCreate() {
        super.onCreate();
        Log.i("lxltest", this.getClass().getSimpleName() + ",onCreate");
    }
}

如果我们输入的筛选内容是：package:com.xt.appplugin

则输出日志内容为：

2023-03-16 10:46:07.059  9333-9333  lxltest                 com.xt.appplugin                     I  button1 press
---------------------------- PROCESS STARTED (9381) for package com.xt.appplugin ----------------------------
2023-03-16 10:46:07.215  9381-9381  ziparchive              com.xt.appplugin                     W  Unable to open '/data/data/com.xt.appplugin/code_cache/.overlay/base.apk/classes3.dm': No such file or directory
2023-03-16 10:46:07.216  9381-9381  .appplugin:aaaa         com.xt.appplugin                     W  ClassLoaderContext classpath size mismatch. expected=0, found=1 (PCL[] | PCL[/data/data/com.xt.appplugin/code_cache/.overlay/base.apk/classes3.dex*1426120062])
2023-03-16 10:46:07.230  9381-9381  GraphicsEnvironment     com.xt.appplugin                     V  ANGLE Developer option for 'com.xt.appplugin' set to: 'default'
2023-03-16 10:46:07.230  9381-9381  GraphicsEnvironment     com.xt.appplugin                     V  ANGLE GameManagerService for com.xt.appplugin: false
2023-03-16 10:46:07.231  9381-9381  GraphicsEnvironment     com.xt.appplugin                     V  Updatable production driver is not supported on the device.
2023-03-16 10:46:07.236  9381-9381  NetworkSecurityConfig   com.xt.appplugin                     D  No Network Security Config specified, using platform default
2023-03-16 10:46:07.236  9381-9381  NetworkSecurityConfig   com.xt.appplugin                     D  No Network Security Config specified, using platform default
2023-03-16 10:46:07.239  9381-9381  lxltest                 com.xt.appplugin

而我们输入的筛选内容如果是：process:com.xt.appplugin:aaaa

则输出内容是：

---------------------------- PROCESS STARTED (9591) for package com.xt.appplugin ----------------------------
2023-03-16 10:47:08.735  9591-9591  ziparchive              com.xt.appplugin                     W  Unable to open '/data/data/com.xt.appplugin/code_cache/.overlay/base.apk/classes3.dm': No such file or directory
2023-03-16 10:47:08.737  9591-9591  .appplugin:aaaa         com.xt.appplugin                     W  ClassLoaderContext classpath size mismatch. expected=0, found=1 (PCL[] | PCL[/data/data/com.xt.appplugin/code_cache/.overlay/base.apk/classes3.dex*1426120062])
2023-03-16 10:47:08.750  9591-9591  GraphicsEnvironment     com.xt.appplugin                     V  ANGLE Developer option for 'com.xt.appplugin' set to: 'default'
2023-03-16 10:47:08.751  9591-9591  GraphicsEnvironment     com.xt.appplugin                     V  ANGLE GameManagerService for com.xt.appplugin: false
2023-03-16 10:47:08.751  9591-9591  GraphicsEnvironment     com.xt.appplugin                     V  Updatable production driver is not supported on the device.
2023-03-16 10:47:08.756  9591-9591  NetworkSecurityConfig   com.xt.appplugin                     D  No Network Security Config specified, using platform default
2023-03-16 10:47:08.757  9591-9591  NetworkSecurityConfig   com.xt.appplugin                     D  No Network Security Config specified, using platform default
2023-03-16 10:47:08.760  9591-9591  lxltest                 com.xt.appplugin                     I  TestService,onCreate
2023-03-16 10:47:13.687  9591-9602  System                  com.xt.appplugin                     W  A resource failed to call close.

区别其实就是少了主进程的下面这条日志：

2023-03-16 10:46:07.059  9333-9333  lxltest                 com.xt.appplugin                     I  button1 press

3.TAG

TAG就比较容易理解了，根据输入的TAG进行筛选。这里的tag使用的是模糊匹配。

比如下面代码：

Log.i("lxltest", "button press");
Log.e("lxl", "button end");

如果我们使用的是：tag:lxl

则最终的输出内容就是，会把所有tag以lxl为前缀的日志全部筛选出来。

2023-03-16 10:49:53.200  9535-9535  lxltest                 com.xt.appplugin                     I  button press
2023-03-16 10:49:53.200  9535-9535  lxl                     com.xt.appplugin

而如果使用lxltest，则只会筛选出button press这一条了。

4.日志级别

日志级别使用的关键词是level，从低到高分别是：verbose/debug/info/warn/error/assert六种级别。

筛选低级别的日志可以打印高级别的日志，反之则不行。

我们仍然用代码来验证下：

Log.v("lxltest", "level verbose");
Log.d("lxltest", "level debug");
Log.i("lxltest", "level info");
Log.w("lxltest", "level warn");
Log.e("lxltest", "level error");
//打印assert级别的日志
Log.println(Log.ASSERT, "lxltest", "level assert");

如果筛选框输入的是：level:verbose，则日志内容输入如下：

如果筛选框输入的是：level:info，则日志内容输入如下：

如果筛选框输入的是：level:assert，则日志内容输入如下：

5.内容

默认输出全部日志如下：

内容筛选支持模糊搜索，筛选框输入：message:level，因为level对所有的字符串都生效，所以日志全部输出，显示如下：

筛选框输入message:level info，因为只能匹配level info这一项，所以显示内容如下：

内容筛选时，输入也可以输入message:'level info'和也可以输入message:level info的效果是一样的。

6.时间

关键词age，我们可以通过这个关键词对日志以时间纬度进行一定的筛选。

比如我想筛选10分钟内的所有日志，则筛选框输入：age:10m即可，其它时间同理，最大支持到天。

单位	介绍
s	秒
m	分钟
h	小时
d	天

值得注意的是，这里的筛选时间指的是以电脑时间对日志的时间进行筛选。举例例子，电脑时间为12:30，手机时间为12:00。筛选10m内所有日志，AS会去寻找所有时间范围在12:20到12:30之间的日志，这肯定是找不到的，所以最终的日志显示就是空。所以使用这一筛选项时，务必保证手机和电脑时间是同步的。

7.多选-且

大多数情况下，单一的某一个筛选条件肯定是不够的，所以就需要多个筛选条件组合起来用。

logcat筛选框中，如果同时输入多个条件，默认情况下不同类型的筛选，是且的关系。

比如如下的日志：

Log.v("lxltest", "level verbose");
Log.d("lxltest", "level debug");
Log.i("lxltest", "xxxxx info");
Log.w("lxltest", "level warn");
Log.e("lxltest", "level error");
Log.println(Log.ASSERT, "lxltest", "level assert");

筛选条件输入两个：message:level level:warn

这时候level verbose的这条日志就会被过滤掉，只显示其余的3条日志，xxxxx info