Loguru日志库中自定义日志级别颜色的正确配置方法

Loguru作为Python生态中广受欢迎的日志记录库，其强大的功能和简洁的API设计深受开发者喜爱。在实际开发中，我们经常需要为不同级别的日志消息配置不同的颜色，以提高日志的可读性。本文将详细介绍如何正确配置Loguru中的日志级别颜色。

常见配置误区

很多开发者初次使用Loguru时，会尝试直接通过logger.level()方法设置颜色，例如：

logger.level("DEBUG", color="<red>")
logger.level("INFO", color="<blue>")

虽然这种语法看起来合理，但实际上单独这样设置是不够的。这是因为Loguru的颜色系统需要同时在两个地方进行配置：

1. 日志级别与颜色的映射关系
2. 日志格式中的颜色标记

完整配置方案

要实现完整的日志颜色定制，需要按照以下步骤操作：

1. 定义日志级别颜色

首先使用logger.level()方法定义各个级别的颜色：

logger.level("DEBUG", color="<red>")
logger.level("INFO", color="<blue>")
logger.level("WARNING", color="<yellow>")
logger.level("ERROR", color="<magenta>")
logger.level("CRITICAL", color="<bold><black bg=white>")

2. 配置日志格式中的颜色标记

在添加日志处理器时，必须在格式字符串中包含颜色标记：

logger.add(
    sink=sys.stderr,
    format="<level>{message}</level>",
    colorize=True,
    level="DEBUG"
)

关键点在于<level></level>这对标签，它们告诉Loguru在何处应用之前定义的颜色。

高级配置技巧

1. 多颜色组合：可以使用多个颜色标签组合，如<bold><red>表示加粗的红色文字

2. 背景色设置：通过bg=参数可以设置背景色，如<white bg=red>

3. 条件着色：可以使用条件表达式实现更复杂的着色逻辑

4. 文件输出：对于文件输出，建议关闭颜色(colorize=False)，因为颜色标记会以原始文本形式写入文件

实际应用示例

以下是一个完整的配置示例，展示了如何在控制台和文件中分别配置带颜色和不带颜色的日志：

from loguru import logger
import sys

# 移除默认配置
logger.remove()

# 控制台输出 - 带颜色
logger.add(
    sink=sys.stderr,
    format="<level>{time:YYYY-MM-DD HH:mm:ss} | {level} | {message}</level>",
    colorize=True,
    level="DEBUG"
)

# 文件输出 - 不带颜色
logger.add(
    "application.log",
    format="{time:YYYY-MM-DD HH:mm:ss} | {level} | {message}",
    colorize=False,
    level="DEBUG"
)

# 定义各级别颜色
logger.level("DEBUG", color="<cyan>")
logger.level("INFO", color="<green>")
logger.level("WARNING", color="<yellow>")
logger.level("ERROR", color="<red>")
logger.level("CRITICAL", color="<bold><white bg=red>")

# 测试日志输出
logger.debug("调试信息")
logger.info("程序启动")
logger.warning("磁盘空间不足")
logger.error("数据库连接失败")
logger.critical("系统崩溃！")

通过以上配置，开发者可以在控制台中看到彩色分级的日志信息，同时在文件中保存干净的日志记录，既美观又实用。

总结