Python logging模块无需额外安装即可实现分级记录、多目标输出、格式自定义和自动轮转；关键在于规避日志不显示、文件未生成、级别被忽略、多进程错乱等常见问题。

Python 自带的 logging 模块足够强大，不用额外装包就能实现分级记录、多输出目标、格式自定义和自动轮转。关键不是“能不能用”，而是“怎么避免踩坑”——比如日志不显示、文件没生成、级别被忽略、多进程写入错乱等。

基础配置：别直接用 print，从 logging.bConfig 开始

刚上手时，最简单可靠的方式是调用 logging.basicConfig() 一次性设定全局行为。它只生效一次，必须在导入其他模块前（或至少在首次调用 logging.debug() 前）执行。

• 设置日志级别：level=logging.INFO 表示 INFO 及以上（INFO、WARNING、ERROR、CRITICAL）才会输出，DEBUG 被静默
• 指定输出位置：filename='app.log' 写入文件；不加该参数则默认输出到控制台
• 统一格式：format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'，其中 %(name)s 默认是 root，后续可换为自定义名称

示例：

import logging
logging.basicConfig(
  level=logging.INFO,
  filename=’run.log’,
  format=’%(asctime)s – %(levelname)s – %(message)s’,
  datefmt=’%Y-%m-%d %H:%M:%S’
)
logging.info(“服务已启动”)

进阶结构：用 getLogger + Handler 实现灵活分流

当项目变大，你需要把不同模块的日志分开存（如 web 请求进 .log，数据库错误进 db.log），或同时输出到文件和控制台——这时就不能只靠 basicConfig，得手动构造 logger 和 handler。

立即学习“”；

一句话/一张图一键智能生成社交媒体图片的AI设计神器

108

• 获取独立 logger：logger = logging.getLogger('api')，名字相同就拿到同一个实例，推荐用模块名（如 __name__）保证层级清晰
• 添加多个 handler：一个 FileHandler 写文件，一个 StreamHandler 打印到终端，各自可设不同级别和格式
• 注意传播（propa）：默认为 True，意味着子 logger 的日志会向上冒泡到 root；若不希望重复打印，设 logger.propagate = False

常见组合：

logger = logging.getLogger(‘db’)
logger.setLevel(logging.DEBUG)

logger.addHandler(fh)
logger.addHandler(sh)

安全轮转：按大小或时间自动切分日志文件

生产环境不能让一个 log 文件无限增长。logging 提供两个内置轮转 handler：

• RotatingFileHandler：按文件大小切分，例如单个最大 5MB，最多保留 5 个旧文件
• TimedRotatingFileHandler：按时间切分，如每天生成一个新文件（when='midnight'），或每小时（when='h'）

关键参数：

# 每个文件不超过 2MB，最多保留 3 个历史文件
handler = RotatingFileHandler(
  ‘.log’,
  maxBytes=2*1024*1024,
  backupCount=3
)

# 每天零点切分，保留 7 天日志
handler = TimedRotatingFileHandler(
  ‘access.log’,
  when=’midnight’,
  interval=1,
  backupCount=7,
  encoding=’utf-8′
)

避坑要点：几个高频问题与解法

很多日志“不工作”，其实只是配置顺序或层级错了：

• 日志没输出？检查是否调用了 basicConfig() 或设置了 logger 级别，且 handler 级别不低于 logger 级别（双重要求）
• ？Windows 控制台默认 GBK，建议在 FileHandler 中显式加 encoding='utf-8'
• 多进程写同一个文件冲突？RotatingFileHandler 不是进程安全的，生产中建议用 ConcurrentLogHandler（需 pip 安装）或改用日志服务（如 syslog、ELK）
• 想在异常时自动打印 traceback？用 logger.exception('出错了')，它等价于 logger.error('出错了', exc_info=True)

以上就是Python日志系统如何搭建_logging模块使用教程【教程】的详细内容，更多请关注php中文网其它相关文章！