logging比print更专业,因其实现了logger、handler、formatter三层解耦,支持多级过滤与滚动写入;basicconfig仅在root未配置时生效,模块化项目应显式创建logger及handler;rotatingfilehandler可实现按大小轮转,需设置maxbytes和backupcount;一个logger可绑定多个handler以同时输出到控制台和文件,但需分别设置各级别;日志输出需同时满足logger和handler的level,且默认propagate为true。

因为 print 没有级别、没有输出目标控制、不记录上下文,而 logging 通过 Logger + Handler + Formatter 三层解耦,天然支持多级过滤和按大小/时间滚动写入文件。
为什么 basicConfig 一配置就失效?
很多同学调用一次 logging.basicConfig() 后,再创建 Logger 却发现日志不输出,或者级别没生效——这是因为 basicConfig 只在 root logger 尚未被配置过时才生效,且它会自动创建一个 StreamHandler 并设置 root 的 level。一旦你手动调用 getLogger('xxx') 并添加 handler,basicConfig 就彻底失效。
实际开发中应避免依赖 basicConfig,尤其在模块化项目里:
- 每个模块用
logging.getLogger(__name__)获取独立 logger,避免全局污染 - 显式创建
Logger、Handler、Formatter,逻辑清晰可控 - 调用
logger.setLevel()设置 logger 级别,同时为每个Handler单独设setLevel(),两者取高者生效
怎么让日志按文件大小自动轮转?
用 RotatingFileHandler 替代 FileHandler,它会在文件达到指定大小后重命名旧文件、新建空文件继续写入。
关键参数:
-
maxBytes:单个日志文件最大字节数(如10*1024*1024表示 10MB) -
backupCount:最多保留几个旧日志文件(如设为5,则保留app.log.1~app.log.5) -
mode='a'(默认)确保追加写入,不是覆盖
示例:
from logging.handlers import RotatingFileHandler
handler = RotatingFileHandler(
filename='train.log',
maxBytes=10*1024*1024,
backupCount=5,
encoding='utf-8'
)
如何同时输出到控制台和滚动日志文件?
一个 Logger 可绑定多个 Handler,分别控制不同输出目标和级别。
典型组合:
- 控制台用
StreamHandler,设为INFO级别,方便实时观察 - 文件用
RotatingFileHandler,设为DEBUG级别,保留全部细节供回溯 - 两个 handler 共享同一个
Formatter,保证时间戳、模块名等字段一致
注意:如果控制台只想要 WARNING 以上,就给 StreamHandler 单独调用 setLevel(logging.WARNING),不影响文件记录 DEBUG。
为什么设置了 DEBUG 却看不到 debug 日志?
这是最常踩的坑:日志是否输出,取决于 logger 级别 和 handler 级别 的双重判断,且取更严格的那个。
比如:
-
logger.setLevel(logging.DEBUG)—— logger 接收所有 >= DEBUG 的日志 -
handler.setLevel(logging.WARNING)—— handler 只输出 >= WARNING 的日志 - 最终只有
WARNING、ERROR、CRITICAL会真正写入该 handler
调试时建议统一设为 DEBUG,上线前再按需收紧 handler 级别;另外确认没调用 logger.propagate = False,否则日志不会向上传递到 root logger,导致控制台无输出。
真正麻烦的不是写几行配置,而是理解 logger 和 handler 各自的 level 如何协作——漏掉任意一层的 setLevel,日志就静默消失。轮转本身很简单,但轮转 + 多目标 + 多级别组合起来,必须每层都显式控制,不能靠“默认”蒙混过关。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











