python日志新姿势,Loguru库的应用
引言
开发过Python程序或通过Python编写自动化脚本,都知道日志对于一个程序的重要性。 Python语言也内建了一个日志处理的标准库 logging
, 但这个库的使用相对比较复杂。
本文我们介绍一个目前很受欢迎的第三方日志框架 Loguru
, 在Github上已有超过22K星标。是一个比 logging
更加直观易用的替代方案。开发者可以专注于业务逻辑而不是日志配置的繁琐细节
Loguru的使用
1. 安装和快速开始
pip install loguru
最简单的使用方式:
from loguru import loggerlogger.debug("Happy logging with Loguru!")
输出:
2025-08-01 14:00:51.069 | DEBUG | __main__:<module>:3 - Happy logging with Loguru!
2. 日志级别
Loguru提供了7个内置日志级别, 并对不同级别设定了不同的默认颜色显示:
级别 | 方法 | 数值 | 用途 |
---|---|---|---|
TRACE | logger.trace() | 5 | 极其详细的调试信息 |
DEBUG | logger.debug() | 10 | 开发调试信息 |
INFO | logger.info() | 20 | 一般信息 |
SUCCESS | logger.success() | 25 | 成功操作通知 |
WARNING | logger.warning() | 30 | 警告信息 |
ERROR | logger.error() | 40 | 错误信息 |
CRITICAL | logger.critical() | 50 | 严重错误 |
示例代码:
from loguru import loggerlogger.trace("A trace message.")
logger.debug("A debug message.")
logger.info("An info message.")
logger.success("A success message.")
logger.warning("A warning message.")
logger.error("An error message.")
logger.critical("A critical message.")
输出:
3. 自定义日志级别
loguru
创建自定义的级别也极为方便,比如创建一个 FATAL
级别的日志
from loguru import logger# 创建自定义级别
logger