当前位置：首页 > 文章列表 > 文章 > python教程 > Python日志模块配置与使用全解析

Python日志模块配置与使用全解析

2026-01-15 16:18:42 0浏览收藏

小伙伴们有没有觉得学习文章很有意思？有意思就对了！今天就给大家带来《Python logging模块使用与配置详解》，以下内容将会涉及到，若是在学习中对其中部分知识点有疑问，或许看了本文就能帮到你！

Python logging模块是标准库中成熟灵活的日志工具，核心在于合理配置、恰当分级与可追溯输出；推荐使用命名logger实例、Handler-Formatter-Level三层协作、分离配置及结构化日志。

Python日志记录教程_logging模块配置与使用实例

Python 的 logging 模块是标准库中成熟、灵活的日志工具，不用安装第三方包就能实现分级记录、多目标输出、格式自定义和运行时动态控制。关键不是“怎么打日志”，而是“怎么让日志真正有用”——这取决于配置是否合理、级别是否得当、输出是否可追溯。

基础用法：从 print 到 logging.getLogger()

直接调用 logging.debug() 或 logging.info() 看似简单，但默认只显示 WARNING 及以上级别，且没有格式、无时间戳，也不写入文件。推荐始终使用 logger 实例：

用 logger = logging.getLogger(__name__) 获取命名 logger，便于按模块区分日志来源
不直接调用顶层函数（如 logging.info()），避免污染 root logger，影响后续配置
首次使用前建议调用 logging.basicConfig() 做简易配置（仅用于脚本调试，正式项目应显式配置）

核心配置：Handler、Formatter、Level 三要素

一条日志从产生到落地，需经过 logger → handler → formatter 三层协作：

Logger：负责接收日志调用、判断是否满足 level 条件、分发给 handler；可通过 setLevel() 设置最低记录级别（如 INFO）
Handler：决定日志输出去向，常见有 StreamHandler（控制台）、FileHandler（普通文件）、RotatingFileHandler（自动轮转）、TimedRotatingFileHandler（按时间切分）
Formatter：定义日志文本结构，常用占位符包括 %(asctime)s、%(name)s、%(levelname)s、%(message)s、%(lineno)d

配置示例（控制台 + 文件双输出）：

import logging
logger = logging.getLogger(name)
logger.setLevel(logging.DEBUG)
控制台输出
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.INFO)
console_formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
console_handler.setFormatter(console_formatter)
文件输出（带轮转）
file_handler = logging.handlers.RotatingFileHandler(
'app.log', maxBytes=510241024, backupCount=3
)
file_handler.setLevel(logging.DEBUG)
file_formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(funcName)s:%(lineno)d - %(message)s')
file_handler.setFormatter(file_formatter)
logger.addHandler(console_handler)
logger.addHandler(file_handler)

实用技巧：过滤、上下文与结构化日志

真实项目中常需更精细控制：

用 Filter 子类可拦截特定条件日志（如排除健康检查请求、只保留某用户 ID 的操作）
借助 LoggerAdapter 注入固定字段，比如每次记录都带上 request_id：adapter = logging.LoggerAdapter(logger, {'request_id': 'abc123'})，之后调用 adapter.info("处理完成") 就会自动补全
结构化日志不依赖 JSON 字符串拼接，而是用 extra 参数传字典，配合自定义 Formatter 提取字段（如 %(user_id)s），再由日志收集系统（如 ELK）解析