使用TimedRotatingFileHandler按日期分割日志，通过设置when="midnight"、interval=1和backupCount=7，可实现每天自动生成新日志文件并保留最近7天记录。配合namer和rotator可自定义归档文件名格式，适用于长期运行服务的日志管理。
Python 中实现日志文件按日期自动分割保存，最常用的方式是使用内置的 logging 模块配合 TimedRotatingFileHandler。这种方式可以根据时间间隔（如每天）自动创建新的日志文件，旧的日志也可以设置保留期限。
1. 使用 TimedRotatingFileHand
ler 按天分割日志
ler 按天分割日志下面是一个按天生成日志文件的基本示例：
import logging from logging.handlers import TimedRotatingFileHandler import os日志目录
log_dir = "logs" os.makedirs(log_dir, exist_ok=True)
配置日志器
logger = logging.getLogger("daily_logger") logger.setLevel(logging.INFO)
定义处理器：每天生成一个新文件，保留最近 7 天的日志
handler = TimedRotatingFileHandler( filename=os.path.join(log_dir, "app.log"), when="midnight", # 在午夜切换 interval=1, # 每1天切换一次 backupCount=7, # 最多保留7个备份 encoding="utf-8" ) handler.suffix = "%Y-%m-%d" # 文件名后缀格式
设置日志格式
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s') handler.setFormatter(formatter)
添加处理器到日志器
logger.addHandler(handler)
示例日志输出
logger.info("这是一条测试日志")
运行后，会在 logs 目录下生成类似 app.log.2025-04-05、app.log.2025-04-06 的文件。当前日志写入 app.log，每天凌晨自动重命名并创建新文件。
2. 自定义日志文件名格式
默认情况下，suffix 控制归档文件的时间格式。如果想让原始日志也带日期，可以自定义命名逻辑：
import time修改 handler 的命名方式
def namer(default_name): return default_name + ".log"
def rotator(source, dest): os.rename(source, dest + ".log")
handler.namer = namer
handler.rotator = rotator # 可选：自定义压缩等操作
这样归档文件会变成 app.log.2025-04-05.log，更清晰易识别。
3. 常见配置说明
when 参数支持的时间单位：
- S: 秒
- M: 分钟
- H: 小时
- D: 天
- midnight: 每天午夜
interval 表示切换频率，如 when="H", interval=2 表示每两小时切一次。
4. 注意事项
确保程序长时间运行，才能触发自动分割。如果是短脚本，可手动调用 doRollover() 测试。
多进程环境下，TimedRotatingFileHandler 可能出现竞争问题，建议结合 concurrent-log-handler 第三方库解决。
基本上就这些。按日期分割日志对长期运行的服务非常实用，便于归档和排查问题。配置一次，后续自动管理，省心又规范。
