Python日志模块全面指南
在软件开发过程中，日志记录是一个不可或缺的环节。通过日志，我们可以跟踪程序的执行情况，排查错误及性能问题，甚至监测应用程序的行为。因此，掌握 Python 的日志模块是每个开发者的必要技能。
什么是日志模块
Python 的日志模块（logging）是一个强大且灵活的工具，用于生成和管理日志信息。它提供了多种级别的日志记录（DEBUG、INFO、WARNING、ERROR、CRITICAL），可以帮助开发者更好地控制和记录程序的运行状态。
基本用法
首先，我们需要引入 Python 的日志模块：
import logging
设置基本配置
我们可以使用 basicConfig() 方法来设置日志的基本配置，例如日志级别、输出格式和输出位置：
import logging
logging.basicConfig(level=logging.DEBUG,
format='%(asctime)s - %(levelname)s - %(message)s',
filename='app.log', # 日志输出到文件
filemode='a') # 追加模式
这个配置将日志级别设置为 DEBUG，输出格式包括时间、日志级别和消息，所有日志都将写入 app.log 文件中。
日志记录示例
一旦设置好了日志配置，就可以记录各种级别的日志信息：
# 记录调试信息
logging.debug('这是一条调试信息')
# 记录一般信息
logging.info('这是一条信息')
# 记录警告信息
logging.warning('这是一条警告信息')
# 记录错误信息
logging.error('这是一条错误信息')
# 记录严重错误信息
logging.critical('这是一条严重错误信息')
控制日志输出位置
除了将日志输出到文件中，日志还可以输出到控制台，使用 StreamHandler 来实现：
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.INFO)
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
console_handler.setFormatter(formatter)
logger = logging.getLogger()
logger.addHandler(console_handler)
在这个示例中，我们创建了一个控制台处理器，并设置其输出级别为 INFO。然后将其添加到日志记录器中，这样 INFO 级别及以上的日志将打印到控制台。
自定义日志记录器
在复杂的应用中，可能需要创建多个日志记录器以便于分类管理。例如，针对不同模块或功能设置不同的日志记录器：
# 创建一个名为 'module_a' 的日志记录器
module_a_logger = logging.getLogger('module_a')
module_a_logger.setLevel(logging.DEBUG)
module_a_handler = logging.FileHandler('module_a.log')
module_a_handler.setFormatter(formatter)
module_a_logger.addHandler(module_a_handler)
module_a_logger.info('这是模块A的一条信息')
上述代码中，我们为模块 A 创建了单独的日志记录器，并将日志输出到 module_a.log 文件中。
日志轮转
在长期运行的应用中，日志文件可能会变得非常庞大，因此需要进行日志轮转。使用 RotatingFileHandler 可以实现这一功能：
from logging.handlers import RotatingFileHandler
# 创建一个日志处理器，最多保存3个日志文件，每个文件最大大小1MB
rotating_handler = RotatingFileHandler('app.log', maxBytes=1e6, backupCount=3)
logger.addHandler(rotating_handler)
通过这个配置，当 app.log 文件达到1MB时，旧的日志文件将被备份并循序替换。
结论
通过 Python 的日志模块，我们能够全面掌控应用程序的运行状态，实现细粒度的日志记录。在开发过程中，合理使用日志可以大幅减少问题排查的时间，提高开发效率。希望这篇日志模块指南能帮助你在项目中有效地使用日志记录。
