解锁LuatOS-log库：全栈工程师的日志管理实战课！

针对全栈开发者设计的实战教程，本文聚焦LuatOS平台log库的高效使用，从基础配置到高级调试策略，手把手教你搭建可扩展的日志系统，提升项目维护效率。

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

一、 log.info()

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

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

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

比如：在一个包含多个子系统的应用程序中，为每个子系统的日志添加相应的标签，开发人员就能快速定位到问题所在的模块。

在一个复杂的Lua脚本里，使用log.info() 函数在关键代码位置，设置输出信息，就能知道程序是否按预期顺序执行。

如果你想在程序开头看是否会记录到模块初始化，代码可以这样写：

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

二、 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库的内容就分享到这里了~

审核编辑 黄宇