Loguru日志库中动态添加日志级别的正确姿势

在Python日志处理领域，Loguru以其简洁易用的API广受欢迎。本文将深入探讨一个常见场景：如何在Loguru中安全地添加自定义日志级别，避免重复定义导致的异常问题。

自定义日志级别的重要性

Loguru默认提供了DEBUG、INFO等标准日志级别，但实际开发中我们经常需要添加具有业务语义的自定义级别。例如添加"TITLE"级别用于输出醒目的标题信息：

logger.level("TITLE", color="<bold><fg 86>", no=21)

重复定义问题分析

在Jupyter Notebook等交互式环境中，代码可能被重复执行。当第二次执行上述代码时，Loguru会抛出TypeError异常，提示级别已存在且无法更新严重性编号。

解决方案对比

方案一：异常捕获法（推荐）

try:
    logger.level("TITLE")
except ValueError:
    logger.level("TITLE", color="<bold><fg 86>", no=21)

这是官方推荐的做法，通过尝试访问级别来检测其是否存在。优点包括：

1. 代码意图明确
2. 符合Python的EAFP（Easier to Ask for Forgiveness than Permission）风格
3. 能准确捕获级别不存在的特定异常

方案二：级别属性检查（备选）

虽然Loguru没有直接提供查询接口，但可以通过以下方式间接实现：

if "TITLE" not in logger._core.levels:
    logger.level("TITLE", color="<bold><fg 86>", no=21)

注意：此方法依赖于内部属性，可能在版本更新时失效。

设计哲学探讨

Loguru选择抛出异常而非静默忽略重复定义，体现了其明确失败的设计哲学：

1. 避免配置冲突导致的意外行为
2. 提醒开发者注意代码执行流程
3. 保持API的严格性和可预测性

最佳实践建议

1. 在模块初始化时集中定义自定义级别
2. 对于可能重复执行的代码（如Jupyter），使用异常捕获模式
3. 为自定义级别选择合理的严重性编号（建议≥20）
4. 考虑使用上下文管理器管理临时级别定义

扩展应用场景

这种模式同样适用于：

• 单元测试中的临时级别设置
• 插件系统的日志扩展
• 多线程环境下的级别配置

通过掌握这些技巧，开发者可以更安全地在Loguru中使用自定义日志级别，构建更具表现力的日志系统。