Python使用logging模块实现日志自动分割与清理

一颗松果

发布时间：2026-10-14 | 3人浏览过

原创

本文介绍如何在Python中利用内置logging模块结合[[wp:a0]]实现日志文件的自动分割与清理。通过自定义Logger类，可配置日志级别、分割周期（如按秒或天）及保留文件数量，自动删除过期日志，确保磁盘空间合理利用。

Python日志自动分割与清理实现

日志是项目开发与运行过程中不可或缺的组件，Python提供了内置的logging模块来支持这一功能。借助 TimedRotatingFileHandler 可以实现按日期自动分割日志文件，并控制保留的日志文件数量。下文将对日志功能进行简单封装并进行测试验证。


import logging
import os
from logging import handlers

class Logger(object):
 # 日志级别关系映射
 level_relations = {
 'debug': logging.DEBUG,
 'info': logging.INFO,
 'warning': logging.WARNING,
 'error': logging.ERROR,
 'critical': logging.CRITICAL
 }

 def __init__(self,
   filename,
   level='info',
   when='D',
   back_count=3,
   fmt='%(asctime)s - %(pathname)s[line:%(lineno)d] - %(levelname)s: %(message)s'):
 f_dir, f_name = os.path.split(filename)
 os.makedirs(f_dir, exist_ok=True) # 当前目录新建log文件夹
 self.logger = logging.getLogger(filename)
 format_str = logging.Formatter(fmt) # 设置日志格式
 self.logger.setLevel(self.level_relations.get(level)) # 设置日志级别
 sh = logging.StreamHandler() # 往屏幕上输出
 sh.setFormatter(format_str) # 设置屏幕上显示的格式
 th = handlers.TimedRotatingFileHandler(filename=filename, when=when, backupCount=back_count,
      encoding='utf-8') # 往文件里写入指定间隔时间自动生成文件的Handler
 # 实例化TimedRotatingFileHandler
 # interval是时间间隔，backupCount是备份文件的个数，如果超过这个个数，就会自动删除，when是间隔的时间单位，单位有以下几种：
 # S 秒
 # M 分
 # H 小时
 # D 天
 # 'W0'-'W6' 每星期（interval=0时代表星期一：W0）
 # midnight 每天凌晨
 th.setFormatter(format_str) # 设置文件里写入的格式
 self.logger.addHandler(sh) # 把对象加到logger里
 self.logger.addHandler(th)

# 测试
if __name__ == '__main__':
 logger = Logger('./logs/2020/app.log', 'debug', 'S', 5).logger
 logger.debug('debug')
 logger.info('info')
 logger.warning('警告')
 logger.error('报错')
 logger.critical('严重')

 # 单独记录error
 err_logger = Logger('./logs/2020/error.log', 'error', 'S', 3).logger
 err_logger.error('错误 error')