当前位置：首页 > news >正文

Python 日志神器 Loguru 超详细使用教程

news 2026/5/29 2:25:24

前言
在 Python 开发中，日志记录是排查问题、监控程序运行的核心工具，但原生 logging 库配置繁琐、语法复杂，新手很难快速上手。Loguru是一款极简、强大、开箱即用的第三方日志库，无需复杂配置，一行代码就能实现专业级日志记录，完美解决原生 logging 的痛点。

Loguru 简介
核心优势：开箱即用、语法简洁、支持彩色输出、自动日志轮转、多进程安全、格式化灵活
适用场景：脚本调试、Web 项目、爬虫、数据分析、生产环境日志监控
替代原生 logging：无需手动创建 Logger、Handler、Formatter，零配置起步

基础使用

快速输出日志
从 loguru 导入 logger 对象，直接调用不同级别日志方法，无需任何配置：

fromloguruimportlogger# 不同日志级别（从低到高）logger.trace("这是 trace 级别日志")logger.debug("这是 debug 级别日志")logger.info("这是 info 级别日志")logger.success("这是 success 级别日志")logger.warning("这是 warning 级别日志")logger.error("这是 error 级别日志")logger.critical("这是 critical 级别日志")

运行效果：
控制台自动彩色输出，不同级别日志颜色不同，辨识度拉满
自动包含时间、级别、代码行号、日志内容，信息完整

进阶使用
生产环境中，我们需要将日志写入文件、自动切割日志、自定义格式，Loguru 一行代码就能实现。

日志写入文件
使用 logger.add() 方法，指定文件路径即可：

fromloguruimportlogger# 日志写入文件（默认追加模式）logger.add("runtime.log")# 测试日志logger.info("程序启动成功")logger.error("测试错误日志")

运行后，项目根目录会生成 runtime.log 文件，所有日志自动持久化存储。

自动日志轮转
避免日志文件过大，Loguru 支持按文件大小、按时间、按日期自动切割日志，无需手动处理：

fromloguruimportlogger# 1. 按文件大小轮转：超过 10MB 自动切割新文件logger.add("size_log.log",rotation="10 MB")# 2. 按时间轮转：每天 0 点生成新日志logger.add("time_log.log",rotation="00:00")# 3. 按时间间隔轮转：每 1 小时切割一次logger.add("interval_log.log",rotation="1 hour")# 4. 保留日志天数：自动删除 7 天前的日志logger.add("retention_log.log",retention="7 days")# 5. 日志文件压缩：自动压缩为 zip 格式logger.add("compress_log.log",compression="zip")

自定义日志格式
通过 format 参数自定义日志输出格式，支持时间、级别、文件名、行号、进程 / 线程 ID 等：

fromloguruimportlogger# 自定义日志格式logger.add("format_log.log",format="{time:YYYY-MM-DD HH:mm:ss} | {level} | {name}:{line} | {message}",encoding="utf-8"# 解决中文乱码)logger.info("自定义格式日志")logger.error("中文测试：接口请求失败")

格式参数说明：
{time}：日志时间（可自定义格式化）
{level}：日志级别
{name}：模块名
{line}：代码行号
{message}：日志内容
{process}：进程 ID
{thread}：线程 ID

过滤日志级别
只输出指定级别的日志，过滤无关信息：

fromloguruimportlogger# 只写入 WARNING 及以上级别的日志到文件logger.add("warning_log.log",level="WARNING")# 控制台仍输出所有级别，文件只记录警告/错误logger.info("这条不会写入文件")logger.warning("这条会写入文件")logger.error("这条会写入文件")

高级特性

结构化日志
对接日志分析平台（如 ELK）时，需要结构化日志，Loguru 直接支持：

fromloguruimportlogger# 输出 JSON 格式日志logger.add("json_log.log",serialize=True# 序列化为JSON)logger.info("用户登录",user_id=1001,username="test")

多文件分类输出
不同级别日志写入不同文件，方便分类排查：

fromloguruimportlogger# 普通信息日志logger.add("info.log",level="INFO",filter=lambdax:x["level"].name=="INFO")# 错误日志logger.add("error.log",level="ERROR")logger.info("普通业务日志")logger.error("系统错误日志")

关闭控制台输出
生产环境无需控制台输出，关闭默认处理器：

fromloguruimportlogger# 关闭默认控制台输出logger.remove()# 仅写入文件logger.add("prod.log")logger.info("生产环境日志，仅写入文件")

生产环境完整实战配置
这是企业项目中最常用的 Loguru 配置，直接复制即可使用：

fromloguruimportloggerimportsys# 1. 关闭默认控制台输出logger.remove()# 2. 控制台输出（彩色，DEBUG级别）logger.add(sys.stdout,level="DEBUG",format="<green>{time:YYYY-MM-DD HH:mm:ss}</green> | <level>{level:8s}</level> | {name}:{line} | {message}",colorize=True)# 3. 文件输出（按天轮转，保留7天，压缩，UTF-8编码）logger.add("logs/app.log",# 建议放在logs文件夹下level="INFO",rotation="00:00",# 每天零点切割retention="7 days",# 保留7天compression="zip",# 压缩历史日志encoding="utf-8",enqueue=True# 多进程安全)# 测试日志if__name__=="__main__":logger.debug("调试模式启动")logger.info("服务启动成功")logger.success("数据库连接完成")logger.warning("磁盘空间不足")logger.error("接口请求超时")