在HarmonyOS 6应用开发中，你是否经历过这样的“日志灾难”：Debug阶段满屏的 console.log让你快速定位问题，但一到Release阶段，敏感信息泄露、日志刷屏导致性能卡顿、关键报错被海量调试信息淹没。更糟糕的是，线上用户反馈“闪退”，你拿到的日志却是一堆无意义的 [INFO]。

这并非日志系统的缺陷，而是开发者缺乏“分级”管理思维。HarmonyOS 6的HiLog系统提供了完整的日志级别控制机制，本文将为你构建一套从“野蛮打印”到“精准管控”的日志治理方案。

一、现场：无差别日志的“三大罪”

1. 敏感信息“裸奔”

场景：在Debug阶段，你为了方便调试，直接打印了完整的用户数据。

// ❌ 危险代码：Release包也会打印敏感信息
console.log("User token: " + user.token); // 线上泄露用户隐私

2. 性能“隐形杀手”

场景：在循环或高频回调中无节制地打印 DEBUG日志。

// ❌ 高频日志拖慢帧率
onScroll() {
  console.log("Scroll position: " + this.offset); // 每秒触发数十次
  // Release包中这些日志本该静默
}

3. 问题定位“大海捞针”

场景：线上用户报错，你拿到日志文件，却发现里面全是 [INFO]级别的正常流程记录，真正的 [ERROR]被淹没在数万行无关信息中。

日志对比（无分级 vs 有分级）：

// ❌ 无分级：全是INFO，找不到重点
[INFO] 页面加载
[INFO] 请求参数: {...}
[INFO] 接口返回: {...}
[INFO] 页面加载
[INFO] 请求参数: {...}

// ✅ 有分级：ERROR一目了然
[INFO] 页面加载
[ERROR] 数据库连接失败，code: 500

二、诊断：HiLog的“五级分类”与生命周期

1. 日志级别金字塔

HarmonyOS 6的HiLog系统将日志分为5个等级，级别越高，事件越严重。

级别	值	使用场景	Release默认
DEBUG​	3	详细调试信息（如函数入参、循环变量）	❌ 不打印
INFO​	4	关键业务流程节点（如页面跳转、接口调用）	✅ 打印
WARN​	5	可恢复的异常（如网络超时后重试）	✅ 打印
ERROR​	6	功能错误（如文件读写失败、接口500）	✅ 打印
FATAL​	7	致命错误（应用即将崩溃）	✅ 打印

关键机制：DEBUG级别的日志在Release包中默认被屏蔽，这是系统级别的保护，无需你手动删除代码。

2. 为什么不能用 console.log？

console.log在HarmonyOS中会被统一识别为 INFO级别，且Tag固定为 JSAPP，导致：

• 无法按模块过滤：所有日志混在一起，难以区分来源。

• 无法控制输出：无法在Release包中自动关闭调试日志。

• 隐私风险：无法标记敏感参数为私有。

三、修复：构建“分级日志”代码规范

1. 基础改造：从 console.log到 hilog

第一步：导入与配置

// ✅ 正确导入（HarmonyOS 6推荐）
import { hilog } from '@kit.PerformanceAnalysisKit';

// 定义领域ID和Tag（便于过滤）
const DOMAIN: number = 0x003201; // 应用自定义领域ID
const TAG: string = 'MainPage';  // 当前模块标签

第二步：分级打印

// ✅ 分级日志示例
hilog.debug(DOMAIN, TAG, "DEBUG: 滚动位置 %{public}d", offset); // 仅Debug可见
hilog.info(DOMAIN, TAG, "用户 %{public}s 登录成功", userName);   // 关键节点
hilog.warn(DOMAIN, TAG, "网络请求超时，尝试重试");               // 可恢复异常
hilog.error(DOMAIN, TAG, "数据库写入失败: %{public}s", errMsg);  // 功能错误

2. 隐私保护：{public}与 {private}标记

核心技巧：在日志格式字符串中，使用 %{public}s和 %{private}s标记参数是否敏感。

// ❌ 危险：直接拼接字符串，token会暴露
hilog.info(DOMAIN, TAG, "请求头: " + headers);

// ✅ 安全：敏感参数标记为private
hilog.info(DOMAIN, TAG, "请求头: Authorization=%{private}s", headers.authorization);

输出效果：[INFO] 请求头: Authorization=<private>（敏感内容被自动脱敏）

3. 性能优化：使用 isLoggable预检查

对于复杂的日志拼接（如JSON序列化），先检查级别可避免不必要的计算。

// ✅ 性能优化：避免不必要的字符串拼接
if (hilog.isLoggable(DOMAIN, TAG, hilog.LogLevel.DEBUG)) {
  let debugData = JSON.stringify(this.bigObject); // 仅在DEBUG开启时执行
  hilog.debug(DOMAIN, TAG, "大数据: %{public}s", debugData);
}

四、进阶：Release包的“静默”与“爆发”

1. 动态级别控制（API 21+）

在测试阶段，你可能需要临时提升Release包的日志级别来排查问题，无需重新打包。

// 设置最低日志级别为DEBUG（临时开启调试）
hilog.setLogLevel(hilog.LogLevel.DEBUG, hilog.PreferStrategy.OVERRIDE);

// 恢复为INFO（正式发布）
hilog.setLogLevel(hilog.LogLevel.INFO, hilog.PreferStrategy.OVERRIDE);

2. 命令行过滤技巧

使用 hdc shell hilog命令，可以按级别和Tag实时过滤日志。

# 只查看ERROR级别的日志
hdc shell hilog -b e

# 只查看特定Tag的日志
hdc shell hilog -T "MainPage"

# 组合过滤：MainPage的WARN及以上级别
hdc shell hilog -b w -T "MainPage"

五、总结：日志分级管理 SOP

1. 禁用 console.log：全面替换为 hilog，按模块定义 DOMAIN和 TAG。

2. 分级打印：

   • DEBUG：调试细节（Release自动静默）。

   • INFO：关键业务流程。

   • WARN/ERROR：异常与错误。

3. 隐私标记：所有动态参数必须加 %{public}或 %{private}。

4. 性能守卫：复杂日志使用 isLoggable预检查。

5. 线上策略：Release包默认只保留 INFO及以上级别，通过命令行动态调整排查问题。

核心法则：在HarmonyOS 6中，“DEBUG是开发者的眼睛，INFO是系统的脉搏，ERROR是救命的信号”。通过分级管理，你的应用将在Debug阶段拥有“显微镜”，在Release阶段保持“静默且安全”。

©著作权归作者所有，如需转载，请注明出处，否则将追究法律责任。