Python logging模块详解：日志级别、格式配置与代码示例

白榆

发布时间：2026-10-13| 6人浏览过

原创

本文详细介绍Python内置logging模块的使用方法，涵盖DEBUG至CRITICAL五种日志级别及其默认行为。通过配置basicSetConfig，可自定义日志输出格式，包含时间、文件名、行号等关键信息。结合代码示例，演示如何同时向控制台和文件输出日志，帮助开发者高效进行调试与运维监控。

Python日志模块概述

Python标准库提供了logging模块，用于记录程序运行时的各类信息。在调试阶段，合理使用该模块能够显著提升问题定位的效率与准确性。

日志级别与输出方法

一、日志级别定义

DEBUG：提供详细信息，通常仅在排查具体问题时启用。

INFO：确认程序按预期正常运行。

WARNING：提示存在潜在问题或异常情况，例如磁盘空间不足，但程序仍可继续执行。

ERROR：表示发生了严重错误，导致部分功能无法执行。

CRITICAL：指示致命错误，程序可能无法继续运行。

上述五个级别分别对应debug()、info()、warning()、error()和critical()五种记录方法。默认情况下，日志记录的最低级别为WARNING，即只有WARNING及以上级别的日志才会被捕获和输出。

日志输出目标与格式配置

二、日志输出目标

完整代码示例


# 这里为了简便，同时处理：输出控制台和保存到文件中

import logging 

# 第一步，创建一个logger 
logger = logging.getLogger() 
logger.setLevel(logging.INFO) # Log等级总开关 

# 第二步，创建一个handler，用于写入日志文件 
logfile = './log.txt' 
fh = logging.FileHandler(logfile, mode='a') # open的打开模式这里可以进行参考
fh.setLevel(logging.DEBUG) # 输出到file的log等级的开关 

# 第三步，再创建一个handler，用于输出到控制台 
ch = logging.StreamHandler() 
ch.setLevel(logging.WARNING)  # 输出到console的log等级的开关 

# 第四步，定义handler的输出格式 
formatter = logging.Formatter("%(asctime)s - %(filename)s[line:%(lineno)d] - %(levelname)s: %(message)s") 
fh.setFormatter(formatter) 
ch.setFormatter(formatter) 

# 第五步，将logger添加到handler里面 
logger.addHandler(fh) 
logger.addHandler(ch) 

# 日志 
logger.debug('这是 logger debug message') 
logger.info('这是 logger info message') 
logger.warning('这是 logger warning message') 
logger.error('这是 logger error message') 
logger.critical('这是 logger critical message')