日志，是开发中不可或缺的工具。普通的日志库太死板，复杂的配置让人头大。今天介绍的 Loguru，是个小而美的 Python 库，用起来清爽优雅，让你彻底告别传统日志库的繁琐操作。
我是浪仔，话不多说，直接上干货！
什么是 Loguru？
Loguru 是一个开箱即用的 Python 日志库，专注于简化日志记录的流程。它用非常简洁的 API 和优雅的功能设计，让开发者能快速记录和管理日志。没有复杂的配置文件，直接 import 就能用，适合所有想要轻松上手的程序员。
一句话总结：Loguru 是写日志的快乐源泉！
为什么选 Loguru？
1. 开箱即用，零配置
传统日志库需要创建 Logger 对象、配置 Handler，还要设定 Formatter……Loguru 不需要！直接 from loguru import logger，一句代码开始写日志。
2. 功能丰富
Loguru 支持日志级别、文件分割、日志回溯、格式定制等功能。它用简洁的方式实现了强大的功能，不管是简单项目还是复杂应用，都能满足需求。
3. 语法优雅
Loguru 的日志方法调用非常简洁，支持链式调用，还可以通过上下文变量传递额外信息，日志格式可读性超强。
4. 内置多种实用功能
自动管理日志文件，支持文件轮转和过期清理。 记录日志时自动捕获错误堆栈信息，排查问题更容易。 日志格式支持丰富的模板定制，还能用颜色美化控制台输出。
Loguru 的核心功能
1. 快速记录日志
from loguru import logger
logger.info("这是一个普通日志")
logger.error("这是一个错误日志")
logger.debug("这是一个调试日志")
不需要复杂配置，直接用 logger.info() 等方法，简单高效。
2. 日志写入文件
想把日志保存到文件？一句代码就能搞定！
logger.add("app.log", rotation="1 MB", retention="10 days", compression="zip")
logger.info("日志会自动写入文件")
** rotation**：当文件达到指定大小时，会自动分割新文件。** retention**：只保留最近的日志文件，过期自动清理。** compression**：支持日志文件自动压缩，节省存储空间。
3. 错误捕获与堆栈信息
Loguru 可以自动捕获异常信息，把堆栈详情记录到日志。
def divide(a, b):
return a / b
try:
divide(10, 0)
except ZeroDivisionError:
logger.exception("捕获到一个错误")
运行结果：
2024-12-30 10:00:00.123 | ERROR | __main__:divide:2 - 捕获到一个错误
Traceback (most recent call last):
File "example.py", line 5, in <module>
divide(10, 0)
File "example.py", line 2, in divide
return a / b
ZeroDivisionError: division by zero
4. 多颜色美化控制台日志
Loguru 的控制台日志输出支持颜色，让重要信息更突出。
logger.info("<green>这是绿色的提示信息</green>")
logger.error("<red>这是红色的错误提示</red>")
5. 自定义日志格式
你可以完全定制日志的输出格式，比如时间、文件名、行号、信息内容等。
logger.add("custom.log", format="{time} {level} {message}")
logger.info("自定义格式日志")
输出：
2024-12-30 10:00:00 INFO 自定义格式日志
Loguru 的安装与使用
1. 安装 Loguru
pip install loguru
2. 一个完整的示例
from loguru import logger
# 添加日志文件，设置轮转和保留时间
logger.add("my_app.log", rotation="500 KB", retention="7 days")
# 写日志
logger.debug("调试信息")
logger.info("普通信息")
logger.warning("警告信息")
logger.error("错误信息")
logger.critical("严重错误")
# 捕获异常
try:
1 / 0
except ZeroDivisionError:
logger.exception("捕获到异常")
Loguru 的应用场景
1. 调试程序
Loguru 提供调试级别的日志输出，帮助开发者快速定位问题。自动捕获堆栈信息的功能，也让你省去手动记录异常的麻烦。
2. 记录运行状态
通过配置日志文件，记录程序的运行状态和重要事件。适合在生产环境中对程序进行监控和追踪。
3. 自动清理日志
Loguru 的日志轮转和清理功能特别适合长期运行的服务，避免日志文件占满磁盘。
4. 分布式系统日志
在分布式系统中，日志记录至关重要。Loguru 的高效文件管理和可扩展性，非常适合这种场景。
小结
Loguru 是一款功能强大又优雅的日志库，不管是新手还是资深开发者都能轻松驾驭。它不仅简化了日志记录的流程，还提供了强大的日志管理功能。如果你想让日志记录更高效、更美观、更方便，Loguru 是你的不二之选！
