Python logging日志分流问题：实现终端与文件独立输出日志

问题根源 #

Python logging模块的logger默认会向上传播日志到父级logger（包括root logger）。你的代码中：

• 调用log.debug()时，root logger会自动创建一个默认的StreamHandler（输出到终端）；
• filelog作为root的子logger，默认propagate=True，所以它的日志会传递到root，导致filelog.debug()的日志既写入文件，又通过root的StreamHandler输出到终端；
• 注释掉log.debug()时，root logger尚未初始化任何handler，所以filelog的日志虽然向上传播，但没有对应的handler处理，因此仅输出到文件。

最优解决方案：关闭子logger的传播特性 #

不需要维护两个独立logger实例，只需在配置filelog时关闭日志向上传播，同时给root logger配置终端输出的handler。这样在多模块场景下，仅需导入logging模块即可分别使用终端和文件日志：

import logging as log

# 配置root logger：负责输出日志到终端
root_logger = log.getLogger()
root_logger.setLevel(log.DEBUG)
# 添加终端输出handler
stream_handler = log.StreamHandler()
root_logger.addHandler(stream_handler)

# 配置file logger：仅输出日志到文件，关闭向上传播
filelog = log.getLogger('file')
filelog.setLevel(log.DEBUG)
file_handler = log.FileHandler('example.log')
filelog.addHandler(file_handler)
filelog.propagate = False  # 关键：阻止日志传递到root logger

# 使用示例
log.debug('仅输出到终端')
filelog.debug('仅输出到文件')

方案优势 #

• 多模块场景下，其他模块无需额外导入logger，直接通过logging.debug()输出到终端，通过logging.getLogger('file').debug()输出到文件；
• 日志职责清晰，root专注终端输出，file logger专注文件输出，避免重复配置；
• 彻底解决日志重复输出的问题。

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