Python中loguru日志库怎么使用

loguru 是一个功能强大且易于使用的 Python 日志库，旨在简化日志记录的过程。相比于 Python 标准库中的 logging 模块，loguru 提供了更加简洁和灵活的 API，使得开发者可以更轻松地记录日志。本文将介绍如何在 Python 项目中使用 loguru 日志库。

1. 安装 loguru

首先，你需要安装 loguru。你可以使用 pip 来安装它：

pip install loguru

2. 基本用法

loguru 的基本用法非常简单。你只需要导入 loguru 的 logger 对象，然后就可以直接使用它来记录日志。

from loguru import logger

logger.info("这是一条信息日志")
logger.debug("这是一条调试日志")
logger.warning("这是一条警告日志")
logger.error("这是一条错误日志")
logger.critical("这是一条严重错误日志")

2.1 日志级别

loguru 支持多种日志级别，包括：

• TRACE：用于非常详细的调试信息。
• DEBUG：用于调试信息。
• INFO：用于常规信息。
• SUCCESS：用于成功信息。
• WARNING：用于警告信息。
• ERROR：用于错误信息。
• CRITICAL：用于严重错误信息。

你可以通过 logger.level() 方法来设置日志级别：

logger.level("INFO")
logger.info("这条日志会被记录")
logger.debug("这条日志不会被记录")

3. 日志格式化

loguru 允许你自定义日志的格式。你可以通过 logger.add() 方法来添加自定义的日志处理器，并指定日志的格式。

logger.add("file.log", format="{time} {level} {message}", level="INFO")
logger.info("这条日志会被记录到 file.log 文件中")

3.1 时间格式化

你可以使用 {time} 占位符来记录日志的时间，并通过 format 参数来指定时间的格式：

logger.add("file.log", format="{time:YYYY-MM-DD HH:mm:ss} {level} {message}", level="INFO")
logger.info("这条日志会记录时间")

4. 日志文件管理

loguru 提供了强大的日志文件管理功能。你可以通过 rotation 参数来设置日志文件的轮转策略。

4.1 按大小轮转

当日志文件达到指定大小时，loguru 会自动创建一个新的日志文件：

logger.add("file.log", rotation="10 MB")
logger.info("这条日志会被记录到 file.log 文件中")

4.2 按时间轮转

你还可以设置日志文件按时间轮转，例如每天轮转一次：

logger.add("file.log", rotation="00:00")
logger.info("这条日志会被记录到 file.log 文件中")

4.3 日志文件保留

你可以通过 retention 参数来设置日志文件的保留时间或数量：

logger.add("file.log", retention="10 days")
logger.info("这条日志会被记录到 file.log 文件中")

5. 异常日志记录

loguru 提供了非常方便的异常日志记录功能。你可以使用 logger.exception() 方法来记录异常信息：

try:
    1 / 0
except ZeroDivisionError:
    logger.exception("发生了除零错误")

6. 日志颜色

loguru 支持在终端中显示彩色日志。你可以通过 logger.add() 方法的 colorize 参数来启用彩色日志：

logger.add(sys.stdout, colorize=True, format="<green>{time}</green> <level>{message}</level>")
logger.info("这条日志会显示为绿色")

7. 日志过滤

你可以通过 filter 参数来过滤日志。例如，你可以只记录特定模块的日志：

def my_filter(record):
    return "my_module" in record["extra"]

logger.add("file.log", filter=my_filter)
logger.bind(my_module=True).info("这条日志会被记录")

8. 日志上下文

loguru 允许你为日志添加上下文信息。你可以使用 logger.bind() 方法来绑定上下文信息：

logger.add("file.log", format="{extra[user]} {message}")
logger = logger.bind(user="Alice")
logger.info("这条日志会记录用户信息")

9. 总结

loguru 是一个功能强大且易于使用的日志库，它提供了丰富的功能和灵活的配置选项。通过本文的介绍，你应该已经掌握了如何在 Python 项目中使用 loguru 来记录日志。无论是简单的日志记录，还是复杂的日志管理，loguru 都能满足你的需求。

希望本文对你有所帮助，祝你在使用 loguru 时能够更加高效地记录和管理日志！