Loguru让Python日志更简单,无需复杂配置即可使用。导入logger后可直接输出调试、信息、警告、错误日志,默认控制台显示info及以上级别。通过logger.add()可将日志写入文件,支持按天轮转、保留策略和级别过滤。支持自定义格式,包含时间、级别、文件、行号等信息,并能用logger.exception()捕获异常堆栈。可移除默认handler并重新配置输出目标,适合全局使用,各模块共享同一logger实例,简化项目日志管理。

Python中使用Loguru操作日志非常简单,它比内置的logging模块更直观、易用。Loguru自动配置好日志输出,无需繁琐设置,开箱即用,并支持颜色高亮、文件写入、异常追踪等功能。
安装Loguru
通过pip安装Loguru:
pip install loguru基本使用方法
导入logger后可直接使用,无需配置:
from loguru import loggerlogger.debug("这是一个调试信息") logger.info("这是一个普通信息") logger.warning("这是一个警告信息") logger.error("这是一个错误信息")
默认情况下,info及以上级别会输出到控制台,debug信息不会显示(除非你保留了该级别)。
立即学习“Python免费学习笔记(深入)”;
添加日志文件输出
使用logger.add()将日志写入文件:
- rotation:日志文件轮转,如按天或按大小("500 MB")
- retention:保留旧日志数量,超出自动删除
- level:写入文件的最低日志级别
格式化日志内容
可以自定义日志格式:
fmt = "{time:YYYY-MM-DD HH:mm:ss} | {level} | {file}:{line} | {message}" logger.add("app.log", format=fmt, level="DEBUG")常用占位符:
........酷源科技旗下产品DoeipOA 2008奥运版,经过精心策划、周密准备和紧密的团队协作,于近日正式推出,功能齐全,操作更加人性化,是公司适应市场发展的需求,以用户为导向努力打造的新一代OA产品。采用了.net平台先进的开发技术,酷源OA办公自动化系统拥有信息交流、工作日志、日程安排、网络硬盘、在线QQ交流等超过三十大项基本功能及上百种子功能模块,包括体验版、标准版、企业版、集团版、
- {time}:时间
- {level}:日志级别
- {file}:文件名
- {line}:行号
- {function}:函数名
- {message}:日志内容
捕获异常和堆栈信息
Loguru能自动打印完整的堆栈跟踪:
try: 1 / 0 except Exception as e: logger.exception("发生异常")logger.exception()等价于error + 堆栈追踪,适合在except块中使用。
移除默认输出或管理多个handler
默认会有一个控制台输出,若要清除并重新配置:
logger.remove() # 移除所有handler logger.add(sys.stdout, level="INFO") # 重新添加控制台 logger.add("error.log", level="ERROR") # 只记录错误日志到文件在项目中全局使用
建议在主程序初始化logger,其他模块直接导入使用:
# main.py from loguru import logger logger.add("app.log", format="{time} | {level} | {message}", level="DEBUG")other_module.py
from loguru import logger logger.info("来自其他模块的信息")
Loguru的logger是全局的,跨模块共享,无需额外配置。
基本上就这些。Loguru简化了日志处理流程,功能强大又不失简洁,适合各类Python项目快速集成日志系统。










