basicconfig无法实现双输出,因其仅在root logger无handler时生效且只支持一个handler;正确做法是手动创建root logger并添加streamhandler和filehandler,分别设置level和formatter。

为什么直接用 basicConfig 无法实现双输出?
因为 basicConfig 只在 root logger 没有 handler 时生效,且只能设置一个 handler。一旦你手动添加了文件 handler,再调用 basicConfig 就不会生效——控制台日志也就没了。这不是配置“漏了”,而是机制限制。
正确做法是:手动创建 root logger,显式添加两个 handler(一个 StreamHandler,一个 FileHandler),并分别设置各自的日志级别和格式。
如何为 console 和 file 设置不同日志级别?
关键不是改 logger 的级别,而是控制每个 handler 的 level。比如你想让 ERROR 及以上写入文件,但 INFO 及以上也输出到控制台,就得:
- root logger 级别设为最低需求(如
DEBUG),确保所有日志都“路过”handler -
StreamHandler的setLevel(logging.INFO) -
FileHandler的setLevel(logging.ERROR)
注意:handler 级别是“过滤器”,不是“增强器”。它只决定该 handler 是否处理这条日志,不改变日志本身级别。
避免重复打印:为什么 INFO 日志可能在控制台和文件里都出现?
常见错误是没关掉 logger 的 propagate,或多个 handler 被重复添加。典型表现:一条 logger.info("test") 在控制台打一次,又在文件里打一次(即使文件 handler 设的是 ERROR)。
排查要点:
- 确认没多次调用
addHandler(尤其在循环或模块重载场景) - 检查是否意外设置了
logger.propagate = True(默认是True,但 root logger 通常不需要传播) - 用
logger.handlers打印当前 handler 列表,看是否重复
简单起见,初始化前先清空:logger.handlers.clear()。
完整可运行示例(带注释)
import logging
<p>logger = logging.getLogger()
logger.setLevel(logging.DEBUG) # root logger 接收所有级别</p><h1>清理已有 handler(防止重复)</h1><p>for h in logger.handlers[:]:
logger.removeHandler(h)</p><h1>控制台输出:INFO 及以上</h1><p>console_handler = logging.StreamHandler()
console_handler.setLevel(logging.INFO)
console_formatter = logging.Formatter('%(levelname)s - %(message)s')
console_handler.setFormatter(console_formatter)
logger.addHandler(console_handler)</p><h1>文件输出:ERROR 及以上</h1><p>file_handler = logging.FileHandler('app.log')
file_handler.setLevel(logging.ERROR)
file_formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
file_handler.setFormatter(file_formatter)
logger.addHandler(file_handler)</p><h1>测试</h1><p>logger.debug("This won't appear anywhere") # 不会输出
logger.info("This appears on console only") # ✅
logger.error("This appears on both") # ✅ console + file</p>
文件路径 app.log 是相对路径,如果脚本在子目录运行,日志会生成在该子目录下——这点容易被忽略,建议用绝对路径或明确 os.path.join(os.path.dirname(__file__), 'app.log')。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











