原创 全栈工程师必备技能：LuatOS-log库实战宝典

从日志基础到性能优化，本教程系统性讲解log库的核心功能与实战技巧，提供完整案例代码，助力开发者构建高效稳定的嵌入式日志系统。

今天，我们一起来认识LuatOS的log库！

一、 log.info()   

log info()主要打印一些正常的信息。比如，记录程序的启动信息、某个模块的初始化完成、重要业务流程的执行等。 

我们利用log.info()，可以清晰了解程序的执行顺序。

tag为日志标识，标识日志来自哪个模块或功能。

当模块完成初始化，就能在日志打印里看到相关信息了。

二、  log.debug()  

log.debug()主要用在开发和调试阶段，记录详细的调试信息。

这些信息方便我们理解程序的执行流程、变量的变化。在开发完成后，可以根据需要关闭这些调试信息，以减少日志量和提高性能。 

具体使用场景如下：

当程序执行到log.debug("进入add函数，a = ".. a.. ", b = ".. b)时，它会输出一条日志，明确显示程序已经进入了add函数。

 

三、log.warn()  

log.warn（）主要用于记录一些警告信息，表示程序遇到了一些可能存在潜在的风险，还没有导致程序出错，但可能需要我们关注的部分。

比如：当文件大小超过1MB，你想输出一条警告信息提醒用户，你就可以在代码中使用log.warn()。

当文件大小超过1MB时，程序就会执行log.warn()这行代码，输出一条警告信息，提醒开发者注意下文件大小。

 

四、  log.error()  

log.error（）主要用于记录错误信息，当程序发生错误或异常情况时，使用这个函数来记录相关的错误信息，以便开发者能够快速定位和解决问题。 

具体应用场景：

当除数为0时，输出错误信息：除数不能为0。

五、log.setLevel()
 

以上是我们常用到的几种日志类型。但有时候，debug是调试时用到的，并不想让用户看到我们的debug类型日志，难道要一个一个删除吗？ 

不用！我们可以用log.setLevel()函数设置日志级别。

在LuatOS的log库中，日志有如下几种类型：

LOG_SILENT（无日志模式）

LOG_DEBUG（debug日志模式）

LOG_INFO（info日志模式）

LOG_WARN（warning日志模式）

LOG_ERROR（error日志模式）

日志级别从低到高依次为：DEBUG < INFO < WARN < ERROR

只有日志级别大于或等于当前设置的级别时，该日志才会被输出。

 

比如日志设置为INFO级别时：DEBUG级别的日志不会输出，而INFO、WARN、ERROR级别的日志会输出。

比如：想设置为INFO日志模式，不要输出debug日志信息，代码就这样写：

其余模式同理。

 

六、log.getLevel()
 

如果想要获取到当前设置的日志级别，我们就需要用到 log.getLevel()函数。

示例如下：

七、log.style()  

设置日志风格，需要使用到log.style(val)函数。 

LuatOS的log库提供了3种日志风格，分别为：默认风格0；调试风格1；调试风格2。

这几种方式的日志呈现形式不同，根据个人习惯调整。

示例如下：

以log.info("ABC", "DEF", 123) 为例, 假设该代码位于main.lua的12行。

那么三种风格的输出样式为：

默认风格0的输出样式为：I/user.ABC DEF 123

调试风格1的输出样式为：I/main.lua:12 ABC DEF 123

对比默认风格0，增加了文件名和代码所在行数。

调试风格2的输出样式为：I/user.ABC main.lua:12 DEF 123

对比其他风格，信息位置排放有所区别。

 

关于log库的内容就分享到这里了~