Loguru日志库自定义日志文件名格式指南

日志文件名格式自定义需求

在使用Python日志库Loguru时，开发者经常需要根据项目需求自定义日志文件的命名格式。默认情况下，Loguru会生成类似password.{date_time_number}.log这样的文件名，但实际项目中可能需要更符合业务逻辑的命名方式。

解决方案实现

通过Loguru提供的API，我们可以轻松实现日志文件名的自定义格式。以下是实现{date_time}.password.log格式的具体方法：

# 首先移除默认的日志处理器
logger.remove(0)

# 添加自定义格式的日志处理器
logger.add(
    "logs\\{time:YYYY-MM-DD-HH-mm-ss}-password.log",  # 自定义文件名格式
    format="{time:YYYY/MM/DD HH:mm:ss} | {level} | {message}",  # 日志内容格式
    rotation="1 day",  # 每天轮转日志
    retention="2 days",  # 保留2天的日志
    delay=True  # 延迟文件创建直到第一条日志写入
)

关键参数解析

1. 文件名格式化：使用{time:YYYY-MM-DD-HH-mm-ss}可以精确到秒的时间戳作为文件名前缀

2. 日志轮转：rotation参数支持多种轮转方式：

   • 按时间间隔（如"1 day"）
   • 按文件大小（如"100 MB"）
   • 特定时间（如"00:00"）

3. 日志保留：retention参数控制历史日志的保留策略，支持：

   • 保留天数（如"2 days"）
   • 保留文件数量（如"10"）

4. 延迟创建：delay=True可以避免创建空日志文件，直到实际有日志写入

高级应用场景

对于更复杂的日志管理需求，可以考虑以下扩展方案：

1. 多环境配置：根据开发、测试、生产环境使用不同的日志格式和保留策略

2. 动态文件名：结合业务变量（如用户ID、会话ID）创建更具标识性的日志文件

3. 日志压缩：配合compression参数实现日志文件的自动压缩归档

4. 分布式日志：在文件名中加入主机名或IP地址，便于在多节点环境下区分日志来源

最佳实践建议

1. 保持日志文件名简洁但信息完整，便于后期检索和分析

2. 为不同类型的日志（如访问日志、错误日志、调试日志）设置不同的文件前缀

3. 合理设置日志轮转和保留策略，避免磁盘空间被日志文件占满

4. 在团队项目中统一日志命名规范，便于协作和维护

通过灵活运用Loguru的这些功能，开发者可以构建出既满足业务需求又便于维护的日志系统，为应用程序的监控和故障排查提供有力支持。