Python logging 优势：多级日志滚动配置详解

Python 的 logging 模块远非 print 的简单替代，它通过 Logger、Handler、Formatter 三层解耦，提供了专业级的日志管理能力——支持精细的多级过滤（DEBUG 到 CRITICAL）、灵活的多目标输出（控制台+滚动文件并存）、以及按大小自动轮转的持久化存储；但其强大也意味着必须显式配置：basicConfig 仅在 root 未初始化时生效，模块化项目应摒弃依赖，改用 getLogger(__name__) + 显式创建 handler + 分别设置 logger 和 handler 的 level；尤其要注意日志最终能否输出，取决于两者 level 的“交集”（取更严格者），而 RotatingFileHandler 的 maxBytes 和 backupCount 则让日志既不爆炸磁盘，也不丢失关键历史。掌握这些机制，才能让日志真正成为调试与运维的可靠眼睛。

因为 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，日志就静默消失。轮转本身很简单，但轮转 + 多目标 + 多级别组合起来，必须每层都显式控制，不能靠“默认”蒙混过关。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~