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

前言在 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,rotation10 MB)# 2. 按时间轮转每天 0 点生成新日志logger.add(time_log.log,rotation00:00)# 3. 按时间间隔轮转每 1 小时切割一次logger.add(interval_log.log,rotation1 hour)# 4. 保留日志天数自动删除 7 天前的日志logger.add(retention_log.log,retention7 days)# 5. 日志文件压缩自动压缩为 zip 格式logger.add(compress_log.log,compressionzip)自定义日志格式通过 format 参数自定义日志输出格式支持时间、级别、文件名、行号、进程 / 线程 ID 等fromloguruimportlogger# 自定义日志格式logger.add(format_log.log,format{time:YYYY-MM-DD HH:mm:ss} | {level} | {name}:{line} | {message},encodingutf-8# 解决中文乱码)logger.info(自定义格式日志)logger.error(中文测试接口请求失败)格式参数说明{time}日志时间可自定义格式化{level}日志级别{name}模块名{line}代码行号{message}日志内容{process}进程 ID{thread}线程 ID过滤日志级别只输出指定级别的日志过滤无关信息fromloguruimportlogger# 只写入 WARNING 及以上级别的日志到文件logger.add(warning_log.log,levelWARNING)# 控制台仍输出所有级别文件只记录警告/错误logger.info(这条不会写入文件)logger.warning(这条会写入文件)logger.error(这条会写入文件)高级特性结构化日志对接日志分析平台如 ELK时需要结构化日志Loguru 直接支持fromloguruimportlogger# 输出 JSON 格式日志logger.add(json_log.log,serializeTrue# 序列化为JSON)logger.info(用户登录,user_id1001,usernametest)多文件分类输出不同级别日志写入不同文件方便分类排查fromloguruimportlogger# 普通信息日志logger.add(info.log,levelINFO,filterlambdax:x[level].nameINFO)# 错误日志logger.add(error.log,levelERROR)logger.info(普通业务日志)logger.error(系统错误日志)关闭控制台输出生产环境无需控制台输出关闭默认处理器fromloguruimportlogger# 关闭默认控制台输出logger.remove()# 仅写入文件logger.add(prod.log)logger.info(生产环境日志仅写入文件)生产环境完整实战配置这是企业项目中最常用的 Loguru 配置直接复制即可使用fromloguruimportloggerimportsys# 1. 关闭默认控制台输出logger.remove()# 2. 控制台输出彩色DEBUG级别logger.add(sys.stdout,levelDEBUG,formatgreen{time:YYYY-MM-DD HH:mm:ss}/green | level{level:8s}/level | {name}:{line} | {message},colorizeTrue)# 3. 文件输出按天轮转保留7天压缩UTF-8编码logger.add(logs/app.log,# 建议放在logs文件夹下levelINFO,rotation00:00,# 每天零点切割retention7 days,# 保留7天compressionzip,# 压缩历史日志encodingutf-8,enqueueTrue# 多进程安全)# 测试日志if__name____main__:logger.debug(调试模式启动)logger.info(服务启动成功)logger.success(数据库连接完成)logger.warning(磁盘空间不足)logger.error(接口请求超时)常见问题解决中文乱码添加 encoding“utf-8” 参数日志不输出检查是否执行了 logger.remove() 且未添加新处理器多进程日志丢失添加 enqueueTrue 参数日志文件不切割检查 rotation 格式是否正确如 10 MB、00:00