在 Python 中，`TimedRotatingFileHandler` 是 `logging.handlers` 模块中提供的一种日志处理方式，它可以按照时间周期对日志文件进行分割。以下是配置 `TimedRotatingFileHandler` 的一个完整示例。 ### 示例配置 以下是一个基于 `TimedRotatingFileHandler` 的日志配置代码片段，用于每天滚动一次日志文件，并将格式化后的日志输出到文件和控制台： ```python import logging import os from logging.handlers import TimedRotatingFileHandler # 创建日志目录（如果不存在） log_dir = "logs" os.makedirs(log_dir, exist_ok=True) # 日志文件路径 log_file = os.path.join(log_dir, "app.log") # 创建 logger logger = logging.getLogger("my_logger") logger.setLevel(logging.DEBUG) # 设置日志级别为 DEBUG # 创建 TimedRotatingFileHandler，按天滚动日志文件 handler = TimedRotatingFileHandler( log_file, when="midnight", # 每天凌晨切换日志文件 interval=1, # 每间隔一天生成一个新的日志文件 backupCount=7, # 保留最多 7 个备份的日志文件 encoding="utf-8" # 文件编码 ) handler.setLevel(logging.DEBUG) # 设置 handler 的日志级别 # 定义日志格式 formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s") handler.setFormatter(formatter) # 将 handler 添加到 logger logger.addHandler(handler) # 添加控制台输出 handler（可选） console_handler = logging.StreamHandler() console_handler.setLevel(logging.INFO) console_handler.setFormatter(formatter) logger.addHandler(console_handler) # 测试日志输出 logger.debug("这是一个调试信息") logger.info("这是一个普通信息") logger.warning("这是一个警告信息") logger.error("这是一个错误信息") ``` ### 配置参数说明 1. **when**: 表示日志文件的滚动时间单位，支持如下值： - `"S"`：秒 - `"M"`：分钟 - `"H"`：小时 - `"D"`：天 - `"W0"`~`"W6"`：表示每周从星期一到星期日的某一天 - `"midnight"`：表示每天的午夜时分 [^3] 2. **interval**: 滚动周期，例如 `when="D"` 和 `interval=1` 表示每天滚动一次。 3. **backupCount**: 最多保留的旧日志文件数量。当超过该数量时，最旧的日志文件将被删除。 4. **encoding**: 日志文件的编码格式，通常使用 `"utf-8"`。 5. **suffix**: 默认情况下，日志文件名会以时间戳作为后缀，格式为 `YYYY-MM-DD_HH-MM`，可以通过自定义 `suffix` 来修改格式。 ### 输出效果 运行上述代码后，会在指定目录下生成类似如下的日志文件： ``` app.log app.log.2025-04-05 app.log.2025-04-06 app.log.2025-04-07 ... ``` 每个文件对应一天的日志记录，且保留最近 7 天的日志文件。