鸿蒙 日志输出方式：HiLog 和 Console

本文同步发表于我的微信公众号，微信搜索 程语新视界 即可关注，每个工作日都有文章更新

一、在鸿蒙（HarmonyOS）应用开发中，HiLog 和 Console 是两种常用的日志输出方式。它们主要区别如下：

特性	HiLog	Console (console.log)
来源与用途	HarmonyOS专属日志系统	JavaScript标准方法，跨平台通用
日志级别	支持DEBUG, INFO, WARN, ERROR, FATAL多级别	仅有基本输出，无明确级别区分（但方法名可体现） ，固定为 INFO
自定义能力	支持自定义日志领域（domain）和标签（Tag）	不支持自定义domain和Tag（固定为‘A03d00/JSAPP’）
性能	经过优化，对性能影响较小	实现简单，大量输出时可能影响性能
日志管理	支持日志分类、过滤、存储等管理功能	缺乏完善的日志管理功能
输出内容识别	易于根据自定义Tag定位代码	所有输出Tag固定，难以精确定位
适用阶段	开发调试和正式发布都适用	主要用于开发调试阶段

日志级别说明（hilog.LogLevel） 

级别	值	使用场景
DEBUG	3	详细流程记录，用于深度问题分析
INFO	4	关键业务节点记录（如登录失败、网络异常）
WARN	5	可恢复的非预期情况（如缓存清理失败）
ERROR	6	严重错误（功能不可用，需人工干预）
FATAL	7	致命错误（应用即将崩溃，无法恢复）

备注：DEBUG级别的日志在正式发布版本中默认不被打印，只有在调试版本或打开调试开关的情况下才会打印。

二、简单理解

可以把 Console 看作是开箱即用的“方便食品”，而 HiLog 则是可以精心调配的“厨房用具”。

• Console 的优势在于简单快捷，特别适合在开发初期快速验证逻辑或输出变量值。
• HiLog 的优势在于强大和规范，它能更好地管理和分析日志，尤其在复杂的项目或正式发布版本中更为重要。

三、注意事项

使用 HiLog 时，需要注意：

• 标签（Tag）长度：标签建议不超过31个字节，超出部分会被截断 。
• 单条日志长度：单条日志内容最多4096字节，超出部分会被截断 。
• 中文处理：在标签中使用中文字符可能会出现乱码或对齐问题，建议使用英文或拼音 。

四、使用建议

• 快速调试与验证：只是想快速查看某个变量的值，或者进行简单的函数执行流程跟踪，使用 console.log 或 console.debug 会更加方便 。

    const currentValue = calculateSomething();
    console.log('Current value:', currentValue); // 快速输出当前值

• 项目开发与正式发布：对于长期维护、需要跟踪问题、或准备发布的项目，强烈推荐使用 HiLog。这是鸿蒙官方推荐的日志方式，能为后续的开发和维护节省大量时间 。

    import hilog from '@ohos.hilog';
    const TAG = 'MyWeatherApp'; // 定义模块标签
    hilog.info(0xA0001, TAG, 'Weather data fetched successfully.'); // 信息级别日志
    hilog.error(0xA0001, TAG, 'Failed to connect to network: %{public}s', errorMsg); // 错误级别日志，并安全地输出错误信息

• 性能敏感场景：当应用需要高频次记录日志（例如实时数据处理、性能监控）时，应优先选择 HiLog，因其对系统性能的影响更小 。

五、总结

   Console 和 HiLog 都是鸿蒙开发中有用的工具，但它们的侧重点不同。Console 适用于简单快速的调试，而 HiLog 则适用于需要更多控制、更好管理、更高性能的正式开发场景。