IIASK插件库

loguru库add_level_color方法常见问题：如何解决颜色不生效的情况？

更新时间

问题现象描述

在使用Python的loguru库时，开发者经常会通过add_level_color()方法为不同日志级别添加自定义颜色。但实际应用中可能出现以下典型症状：

  • 终端输出仍显示默认颜色
  • 部分级别颜色生效而其他级别无效
  • 颜色只在某些环境下生效
  • ANSI转义序列直接显示为文本

根本原因分析

经过对大量案例的研究，我们发现颜色不生效通常由以下因素导致：

1. 终端兼容性问题

ANSI颜色代码需要终端支持才能正确渲染。Windows的CMD默认不支持ANSI转义序列，需要通过os.system("color")启用或改用支持ANSI的终端（如Windows Terminal）。

import os
import sys
from loguru import logger

if sys.platform == "win32":
    os.system("color")  # 启用Windows ANSI支持

2. 日志级别未正确注册

使用add_level()创建自定义级别后，必须确保：

  • 级别名称与add_level_color()调用完全匹配
  • 级别数值符合loguru的层级体系（DEBUG=10，INFO=20等）

3. 格式字符串冲突

当自定义format中包含颜色标记时，可能与add_level_color产生冲突。建议统一使用一种着色方式。

解决方案实践

完整配置示例

from loguru import logger
import sys

# 先移除默认处理器
logger.remove()

# 添加自定义级别
logger.level("CUSTOM", no=15, color="")

# 配置带颜色的处理器
logger.add(
    sys.stdout,
    format="{level: <8} | {time:YYYY-MM-DD HH:mm:ss} | {message}",
    level="DEBUG",
    colorize=True  # 必须启用颜色
)

跨平台兼容方案

使用colorama库可确保跨平台颜色支持：

from colorama import init
init(autoreset=True)

logger.add(
    sys.stdout,
    format="...",
    colorize=True
)

高级调试技巧

当问题仍无法解决时，可尝试：

  1. 检查环境变量PYCHARM_HOSTED（IDE可能禁用颜色）
  2. 测试原始ANSI代码：print("\033[31mRed Text\033[0m")
  3. 使用logger.configure(patcher=...)动态修改颜色

性能优化建议

在高并发场景下，颜色处理可能影响性能：

  • 生产环境可关闭颜色（colorize=False）
  • 使用enqueue=True避免多线程颜色冲突
  • 考虑缓存格式化字符串

通过以上方法，开发者可以系统性地解决loguru着色问题，并构建更健壮的日志系统。