Python logging中为单个logger批量添加多个handler的高效方法

Python 标准库的 logging 模块原生没有提供直接传入handler列表进行批量绑定的API，你想通过批量处理简化代码的思路是完全可行的，常见的高效实现方式有以下几种：

方案1：轻量循环绑定 #

适合handler数量不多、不需要统一管理配置的场景，直接将所有handler存入列表后循环调用addHandler即可：

# 声明所有已实例化的handler
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.INFO)
summary = logging.FileHandler(filename='text_logger.txt', mode='w')
summary.setLevel(logging.INFO)
overview = logging.FileHandler(filename='overview.log', mode='w')

# 批量绑定
logger = logging.getLogger('logger')
logger.setLevel(logging.DEBUG)
for handler in [console_handler, summary, overview]:
    logger.addHandler(handler)

方案2：官方推荐的字典配置方案 #

如果你的项目需要管理多个logger、多个handler，且需要统一配置日志格式、过滤规则等参数，可以使用logging.config.dictConfig直接在配置中指定logger绑定的handler列表，无需手动调用addHandler：

import logging.config

LOGGING_CONFIG = {
    "version": 1,
    "disable_existing_loggers": False,
    "loggers": {
        "logger": {  # 对应你要获取的logger名称
            "level": "DEBUG",
            "handlers": ["console", "summary_file", "overview_file"]  # 直接指定要绑定的handler列表
        }
    },
    "handlers": {
        "console": {
            "class": "logging.StreamHandler",
            "level": "INFO"
        },
        "summary_file": {
            "class": "logging.FileHandler",
            "level": "INFO",
            "filename": "text_logger.txt",
            "mode": "w"
        },
        "overview_file": {
            "class": "logging.FileHandler",
            "filename": "overview.log",
            "mode": "w"
        }
    }
}

# 加载配置后直接获取logger即可，不需要手动绑定handler
logging.config.dictConfig(LOGGING_CONFIG)
logger = logging.getLogger("logger")

这种方式所有日志相关配置集中维护，后续新增handler、修改参数都只需要调整配置字典，不用修改业务代码，更适合中大型项目使用。

方案3：封装通用工具函数 #

如果需要在多个地方重复使用批量绑定逻辑，可以封装成通用函数复用：

def add_handlers(logger: logging.Logger, handlers: list[logging.Handler]) -> None:
    for handler in handlers:
        logger.addHandler(handler)

# 调用示例
add_handlers(logger, [console_handler, summary, overview])

额外优化提示 #

如果所有handler需要使用相同的日志格式、过滤器，可以在循环绑定时统一设置，避免重复编码：

formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
for handler in [console_handler, summary, overview]:
    handler.setFormatter(formatter)
    logger.addHandler(handler)

内容的提问来源于stack exchange，提问作者Pranjal Doshi