HarmonyOS NEXT开发进阶（十九）：如何在 DevEco Studio 中查看已安装应用的运行日志

文章目录

- [一、使用 Log 窗口（最常用）](#一、使用 Log 窗口（最常用）)
- - [1.1 打开 Log 窗口](#1.1 打开 Log 窗口)
  - [1.2 配置日志过滤器](#1.2 配置日志过滤器)
- 二、使用命令行工具查看
- - [2.1 通过 hdc 命令行](#2.1 通过 hdc 命令行)
  - [2.2 保存日志到文件](#2.2 保存日志到文件)
- [三、在 DevEco Studio 中实时监控](#三、在 DevEco Studio 中实时监控)
- - [3.1 运行应用时自动显示](#3.1 运行应用时自动显示)
  - [3.2 自定义日志配置](#3.2 自定义日志配置)
- 四、高级日志查看技巧
- - [4.1 多标签查看](#4.1 多标签查看)
  - [4.2 日志颜色标记](#4.2 日志颜色标记)
  - [4.3 快速搜索](#4.3 快速搜索)
  - [4.4 清空日志](#4.4 清空日志)
- 五、常见问题解决
- - [5.1 看不到应用日志](#5.1 看不到应用日志)
  - [5.2 日志太多难以筛选](#5.2 日志太多难以筛选)
  - [5.3 保存历史日志](#5.3 保存历史日志)
- 六、代码中的日志输出

在 DevEco Studio 中查看已安装应用的运行日志，有以下几种方法：

一、使用 Log 窗口（最常用）

1.1 打开 Log 窗口

方式一：点击底部工具栏的 Log 标签页
方式二：菜单栏 → View → Tool Windows → Log
方式三：快捷键 Alt+6 （Windows/Linux）或 Option+6（Mac）

1.2 配置日志过滤器

在 Log 窗口顶部：

设备选择：选择连接的设备或模拟器
进程过滤：选择要查看的应用进程
日志级别：Verbose、Debug、Info、Warn、Error
关键字过滤：输入关键词筛选特定日志

二、使用命令行工具查看

2.1 通过 hdc 命令行

bash 复制代码

# 连接到设备
hdc shell

# 查看实时日志
hilog

# 按标签过滤
hilog -T "YourTag"

# 按进程ID过滤
hilog --process your.package.name

# 查看指定级别的日志
hilog -l D  # D=Debug, I=Info, W=Warn, E=Error

# 查看最近的日志
hilog -x

2.2 保存日志到文件

bash 复制代码

# 保存日志到本地文件
hilog > log.txt

# 从设备拉取日志文件
hdc file recv /data/log/hilog/ ./hilog/

三、在 DevEco Studio 中实时监控

3.1 运行应用时自动显示

运行或调试应用时，Log 窗口会自动打开
显示应用启动和运行期间的实时日志

3.2 自定义日志配置

在项目根目录的 build-profile.json5 中配置：

json5 复制代码

{
  "app": {
    "signingConfigs": [],
    "products": [
      {
        "name": "default",
        "signingConfig": "default",
        "hilogEnabled": true,  // 确保日志开启
        "debugEnabled": true   // 调试模式
      }
    ]
  }
}

四、高级日志查看技巧

4.1 多标签查看

可以打开多个 Log 窗口，分别监控不同进程
右键点击 Log 标签 → Split Right/Down

4.2 日志颜色标记

红色：Error 级别
黄色：Warn 级别
绿色：Info 级别
蓝色：Debug 级别

4.3 快速搜索

Ctrl+F：在当前日志中搜索
支持正则表达式搜索

4.4 清空日志

点击 Log 窗口工具栏的 Clear Log 按钮
或使用快捷键 Ctrl+L

五、常见问题解决

5.1 看不到应用日志

检查设备是否已连接：hdc list targets
确认应用正在运行
检查应用的日志级别设置

5.2 日志太多难以筛选

使用进程过滤器
设置合适的日志级别
添加关键字过滤

5.3 保存历史日志

点击 Log 窗口的 Save Log 按钮
自动保存为 .log 文件

六、代码中的日志输出

在应用代码中使用 HiLog API：

typescript 复制代码

import { HiLog } from '@kit.PerformanceAnalysisKit';

// 输出日志
HiLog.debug(0x0000, "tag", "Debug message");
HiLog.info(0x0000, "tag", "Info message");
HiLog.warn(0x0000, "tag", "Warning message");
HiLog.error(0x0000, "tag", "Error message");

建议：开发调试时，使用 DevEco Studio 的 Log 窗口最方便；需要详细分析或自动化测试时，使用 hdc 命令行工具。