Python日志系统如何搭建_logging模块使用教程【教程】-Python教程-PHP中文网

Python日志系统如何搭建_logging模块使用教程【教程】

舞夢輝影

发布： 2025-12-20 23:01:16

原创

478人浏览过

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

python日志系统如何搭建_logging模块使用教程【教程】

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

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

刚上手时，最简单可靠的方式是调用 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 请求进 access.log，数据库错误进 db.log），或同时输出到文件和控制台——这时就不能只靠 basicConfig，得手动构造 logger 和 handler。

立即学习“Python免费学习笔记（深入）”；

Phidata

Phidata是一个开源框架，可以快速构建和部署AI智能体应用

173

查看详情

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

常见组合：

logger = logging.getLogger('db')
logger.setLevel(logging.DEBUG)

# 文件 handler（只存 ERROR）
fh = logging.FileHandler('db_error.log')
fh.setLevel(logging.ERROR)
fh.setFormatter(logging.Formatter('%(levelname)s:%(message)s'))

# 控制台 handler（显示 DEBUG 起）
sh = logging.StreamHandler()
sh.setLevel(logging.DEBUG)
sh.setFormatter(logging.Formatter('%(name)s - %(message)s'))

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

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

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

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

关键参数：

# 每个文件不超过 2MB，最多保留 3 个历史文件
handler = RotatingFileHandler(
  'app.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)