Python日志管理:loguru使用教程
时间:2026-05-12 22:30:33 110浏览 收藏
Loguru为Python开发者提供了一种极简高效的日志管理方案——无需繁琐配置即可开箱即用,支持控制台彩色输出、文件自动轮转与保留、灵活的级别过滤、自定义格式(含时间、文件、行号等关键信息)、异常堆栈一键捕获,还能轻松移除默认处理器并按需重定向日志到多个目标;其全局共享的logger实例让跨模块日志统一管理变得轻而易举,显著优于标准logging模块的复杂性,是现代Python项目快速集成专业日志系统的不二之选。

Python中使用Loguru操作日志非常简单,它比内置的logging模块更直观、易用。Loguru自动配置好日志输出,无需繁琐设置,开箱即用,并支持颜色高亮、文件写入、异常追踪等功能。
安装Loguru
通过pip安装Loguru:
pip install loguru基本使用方法
导入logger后可直接使用,无需配置:
from loguru import loggerlogger.debug("这是一个调试信息") logger.info("这是一个普通信息") logger.warning("这是一个警告信息") logger.error("这是一个错误信息")
默认情况下,info及以上级别会输出到控制台,debug信息不会显示(除非你保留了该级别)。
添加日志文件输出
使用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")常用占位符:
- {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项目快速集成日志系统。
到这里,我们也就讲完了《Python日志管理:loguru使用教程》的内容了。个人认为,基础知识的学习和巩固,是为了更好的将其运用到项目中,欢迎关注golang学习网公众号,带你了解更多关于java,php,编程的知识点!
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
129 收藏
-
378 收藏
-
206 收藏
-
319 收藏
-
110 收藏
-
298 收藏
-
231 收藏
-
462 收藏
-
362 收藏
-
490 收藏
-
433 收藏
-
102 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习