鸿蒙三方库 | harmony-utils之LogUtil日志输出与级别控制详解

前言日志是开发调试和问题排查的重要工具。pura/harmony-utils的LogUtil封装了日志输出方法支持不同日志级别和标签管理让日志输出更加规范和可控。本文将从API说明、代码实战、进阶用法、常见问题等多个维度进行全面讲解帮助开发者快速掌握并应用到实际项目中。一、LogUtil核心APILogUtil提供了以下日志输出方法方法说明参数使用场景debug(tag, msg)输出DEBUG级别日志tag, msg调试信息info(tag, msg)输出INFO级别日志tag, msg一般信息warn(tag, msg)输出WARN级别日志tag, msg警告信息error(tag, msg)输出ERROR级别日志tag, msg错误信息setLogLevel(level)设置日志级别level级别控制1.1 核心特性简洁易用封装复杂API为一行调用降低使用门槛类型安全完整的TypeScript类型定义编译期即可发现错误异常处理内置异常捕获机制避免运行时崩溃级别控制支持动态设置日志输出级别1.2 日志级别对照级别常量说明生产环境DEBUGLogLevel.DEBUG调试信息不输出INFOLogLevel.INFO一般信息可选WARNLogLevel.WARN警告信息输出ERRORLogLevel.ERROR错误信息输出二、完整使用步骤2.1 安装依赖ohpminstallpura/harmony-utils2.2 输出不同级别日志import{LogUtil}frompura/harmony-utils;Button(输出DEBUG日志).width(100%).onClick((){LogUtil.debug(MyApp,这是一条调试日志);this.resultDEBUG日志已输出 ;})Button(输出INFO日志).width(100%).onClick((){LogUtil.info(MyApp,这是一条信息日志);this.resultINFO日志已输出 ℹ️;})Button(输出ERROR日志).width(100%).onClick((){LogUtil.error(MyApp,这是一条错误日志);this.resultERROR日志已输出 ❌;})2.3 设置日志级别Button(设置日志级别).width(100%).onClick((){LogUtil.setLogLevel(LogLevel.INFO);this.result日志级别已设为INFO\n低于INFO的日志将不输出;})三、完整页面示例import{LogUtil}frompura/harmony-utils;EntryComponentstruct LogDemo{Stateresult:string;build(){Column({space:12}){Button(输出全部级别日志).width(100%).onClick((){LogUtil.debug(Demo,调试信息);LogUtil.info(Demo,一般信息);LogUtil.warn(Demo,警告信息);LogUtil.error(Demo,错误信息);this.result四级日志已输出\n查看HiLog查看日志;});Text(this.result).fontSize(14).fontColor(#333333)}.padding(16)}}四、进阶用法4.1 日志工具类封装import{LogUtil}frompura/harmony-utils;classAppLogger{privatestaticTAGMyApp;staticd(msg:string):void{LogUtil.debug(AppLogger.TAG,msg);}statici(msg:string):void{LogUtil.info(AppLogger.TAG,msg);}staticw(msg:string):void{LogUtil.warn(AppLogger.TAG,msg);}statice(msg:string):void{LogUtil.error(AppLogger.TAG,msg);}}4.2 条件日志输出functionlogIf(condition:boolean,tag:string,msg:string):void{if(condition){LogUtil.info(tag,msg);}}五、注意事项标签规范建议使用统一的标签命名规范级别控制生产环境建议设置为WARN或ERROR敏感信息不要在日志中输出敏感信息初始化依赖使用前需确保AppUtil.init()已调用日志量避免在高频方法中输出大量日志六、常见问题Q1: 日志在HiLog中看不到检查日志级别设置确保当前级别允许输出。同时检查HiLog的过滤条件。Q2: setLogLevel()设置后不生效确认设置时机是否正确建议在应用启动时设置。Q3: 如何查看日志使用DevEco Studio的HiLog工具或通过 hdc hilog 命令查看。Q4: 日志输出影响性能吗大量日志输出会影响性能生产环境建议设置较高级别。总结LogUtil的日志输出方法为开发调试提供了规范化支持。本文详细介绍了核心API、使用步骤、完整示例、进阶用法以及常见问题的解决方案。合理使用日志级别和标签可以提高开发效率和问题排查速度。本文基于pura/harmony-utils工具库更多功能请参考官方文档与后续系列文章。