Python 的 logging 模块是一个功能强大的日志记录系统，它允许你记录各种级别的日志信息，包括调试信息、信息消息、警告、错误和严重错误。通过使用 logging 模块，你可以有效地监控和调试你的应用程序。

以下是一些关于如何使用 logging 模块的基本指南和示例：

基本用法

1. 导入模块：

   python">import logging
   

2. 配置日志记录器：
   你可以通过配置日志记录器来指定日志的级别、格式和输出位置（例如，控制台或文件）。

3. 创建和配置日志记录器：

   python"># 创建一个日志记录器
   logger = logging.getLogger('my_logger')
   logger.setLevel(logging.DEBUG)  # 设置日志级别# 创建一个控制台处理器并设置级别
   console_handler = logging.StreamHandler()
   console_handler.setLevel(logging.DEBUG)# 创建一个格式化器并将其添加到处理器
   formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
   console_handler.setFormatter(formatter)# 将处理器添加到日志记录器
   logger.addHandler(console_handler)
   

4. 记录日志：

   python">logger.debug('This is a debug message')
   logger.info('This is an info message')
   logger.warning('This is a warning message')
   logger.error('This is an error message')
   logger.critical('This is a critical message')
   

示例代码

以下是一个完整的示例，展示了如何配置和使用 logging 模块：

python">import logging# 配置日志记录器
def setup_logger(name, log_file, level=logging.INFO):handler = logging.FileHandler(log_file)handler.setLevel(level)formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')handler.setFormatter(formatter)logger = logging.getLogger(name)logger.setLevel(level)logger.addHandler(handler)return logger# 创建日志记录器
logger = setup_logger('my_app', 'my_app.log')# 记录日志
logger.debug('This is a debug message')
logger.info('This is an info message')
logger.warning('This is a warning message')
logger.error('This is an error message')
logger.critical('This is a critical message')

日志级别

logging 模块定义了以下几个日志级别，级别从低到高排列：

• DEBUG：详细信息，典型地用于诊断问题。
• INFO：确认事情按预期工作。
• WARNING：表明发生了一些意外情况，或指明在不久的将来会发生某些问题（例如，“磁盘空间低”）。软件还能按预期工作。
• ERROR：由于更严重的问题，软件已不能执行某些功能了。
• CRITICAL：严重错误，指明软件已不能继续运行了。

捕获和处理异常

你还可以使用 logging 模块来捕获和处理异常：

python">try:# 可能会引发异常的代码1 / 0
except Exception as e:logger.error('An error occurred', exc_info=True)

高级用法

logging 模块还支持许多高级特性，比如多个处理器、日志记录器的层次结构、日志轮转等。你可以查阅官方文档以获取更多详细信息。

官方文档链接: logging — Logging facility for Python

希望这些信息对你使用 Python 的 logging 模块有所帮助！