Python基础学习之logging模块

news2024/9/25 11:22:25

在Python编程中，日志记录（Logging）是一个非常重要的功能。它不仅可以帮助我们追踪和调试代码中的错误，还可以记录程序运行时的关键信息，以便后续分析和优化。Python标准库中的logging模块为我们提供了强大的日志记录功能。下面，我将详细介绍logging模块的基本用法和一些高级特性。

一、基本用法

1. 导入logging模块

首先，我们需要导入logging模块：

import logging

2. 配置基本日志器

默认情况下，logging模块提供了一个根日志器（root logger），但我们需要进行一些配置才能使用它。下面是一个基本的配置示例：

logging.basicConfig(level=logging.DEBUG,  
                    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',  
                    handlers=[logging.StreamHandler()])

level：指定日志的最低级别，这里我们设置为DEBUG，表示DEBUG级别及以上的日志都会被记录。
format：指定日志输出的格式。这里我们使用了几个占位符：%(asctime)s表示时间戳，%(name)s表示日志器的名称，%(levelname)s表示日志级别，%(message)s表示日志消息。
handlers：指定日志处理器。这里我们使用了StreamHandler，它会将日志输出到控制台。

3. 记录日志

配置好日志器后，我们就可以使用它来记录日志了：

logging.debug('这是一条DEBUG级别的日志')  
logging.info('这是一条INFO级别的日志')  
logging.warning('这是一条WARNING级别的日志')  
logging.error('这是一条ERROR级别的日志')  
logging.critical('这是一条CRITICAL级别的日志')

二、高级特性

1. 自定义日志器

除了使用根日志器外，我们还可以创建自定义的日志器：

logger = logging.getLogger('my_logger')  
logger.setLevel(logging.INFO)  
  
# 创建一个文件处理器，将日志写入文件  
file_handler = logging.FileHandler('my_log.log')  
file_handler.setLevel(logging.INFO)  
  
# 创建一个控制台处理器，将日志输出到控制台  
console_handler = logging.StreamHandler()  
console_handler.setLevel(logging.WARNING)  
  
# 定义日志格式  
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')  
file_handler.setFormatter(formatter)  
console_handler.setFormatter(formatter)  
  
# 将处理器添加到日志器  
logger.addHandler(file_handler)  
logger.addHandler(console_handler)  
  
# 记录日志  
logger.info('这是一条自定义日志器的INFO级别日志')  
logger.warning('这是一条自定义日志器的WARNING级别日志')

在这个例子中，我们创建了一个名为my_logger的自定义日志器，并将它的级别设置为INFO。然后，我们创建了一个文件处理器和一个控制台处理器，并将它们分别添加到日志器中。这样，我们就可以通过logger对象来记录日志了。