


























Loguru 是 GitHub 上最受欢迎的 Python 第三方日志库(21000+ star)。它的卖点就一句话:把标准库要求的那堆配置样板几乎全干掉了。
只需导入一个预配置好的 logger 对象就能开始写日志:
from loguru import logger logger.info("Request processed", method="GET", status=200, latency_ms=47)
2026-05-07 09:54:58.566 | INFO | __main__:<module>:3 - Request processed
没有 handler 设置,没有 formatter 配置,没有 getLogger(__name__) 模式。
getLogger(__name__) 模式是标准库 logging 的惯例:每个模块顶部写 logger = logging.getLogger(__name__) ,以模块路径(比如 "a.b.c" )为名创建一个具名 logger。这套体系中 logger 名形成层级——父 logger 的配置(级别、handler)会自动传给子 logger,例如 "a.b" 继承 "a" 的配置。Loguru 抛弃了这个设计,直接给你一个全局能用的 logger 对象,导入就能写日志。
默认输出是带颜色的、人类可读的 stderr,在开发阶段这正好是你想要的行为。需要改输出目标、格式或过滤行为时,只需要调用 add() 方法:
from loguru import logger import sys logger.remove() logger.add(sys.stdout, serialize=True, level="INFO") logger.info("structured output")
{"text": "2026-05-07 09:54:59.429 | INFO | __main__:<module>:6 - structured output\n", "record": {"elapsed": {"repr": "0:00:00.015865", "seconds": 0.015865}, ...}}
serialize=True 一行就把每条日志转成 JSON 输出,不用写自定义 formatter,不用装额外包。
异常处理是 Loguru 的另一个亮点。 @logger.catch 装饰器包裹一个函数后,异常发生时自动记录完整 traceback 和局部变量值:
from loguru import logger @logger.catch def process_order(order_id: str): raise ValueError(f"invalid order: {order_id}") process_order("bad-123")
2026-05-07 09:55:00.314 | ERROR | __main__:<module>:7 - An error has been caught in function '<module>', process 'MainProcess'
Traceback (most recent call last):
File "/tmp/test_loguru_catch.py", line 7, in <module>
process_order("bad-123")
File "/tmp/test_loguru_catch.py", line 5, in process_order
raise ValueError(f"invalid order: {order_id}")
ValueError: invalid order: bad-123
上下文管理方面,Loguru 用 bind() 给 logger 实例绑定字段,用 contextualize() 上下文管理器做作用域限定的、自动清理的上下文:
from loguru import logger with logger.contextualize(request_id="abc-123"): logger.info("Processing started") logger.info("Processing complete")
对于已经在用标准库 logging 的项目,Loguru 内置了 InterceptHandler 模式,把所有标准库日志路由到 Loguru 的管道,可以渐进式迁移,不用重写已有代码:
import logging from loguru import logger class InterceptHandler(logging.Handler): def emit(self, record): level = logger.level(record.levelname).name logger.opt(depth=6, exception=record.exc_info).log(level, record.getMessage()) logging.basicConfig(handlers=[InterceptHandler()], level=0, force=True) logging.getLogger("some_lib").warning("routed through loguru")
2026-05-07 09:55:02.024 | WARNING | __main__:<module>:10 - routed through loguru
Loguru 的主要取舍是它使用单一的全局 logger 对象,配置是进程级别的。如果不同组件需要不同的日志行为(比如想让数据库模块的日志级别设成 DEBUG、其他模块保持 INFO),就得换一种机制来实现。标准库的具名 logger 层级天然支持这件事—— getLogger("app.db") 继承 getLogger("app") 的配置,同时可以单独覆盖——而 Loguru 缺失了这个能力。
OpenTelemetry 方面,Loguru 没有原生的 OTel 集成。如果只需要在日志里带上 trace ID 和 span ID 做关联,官方 recipe 提供了通过 patcher 函数注入的方式。但如果要通过 OTLP 协议把日志作为 OTel 原生信号导出,就需要通过 InterceptHandler 路由到标准库,再经过 OTel 的 LoggingHandler ,多了一层中转,而标准库和 structlog(通过 stdlib 后端)不需要。
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。