Python 输出到 Log
在开发过程中，我们经常需要输出一些信息来进行调试或者日志记录。Python 提供了多种方式来输出信息，其中一种常用的方式是将信息输出到日志文件中。本文将介绍如何使用 Python 将信息输出到日志文件，并提供一些实际应用的代码示例。
为什么需要输出到 Log
在开发过程中，输出到 Log 是一种常用的调试和日志记录方式。通过将信息输出到日志文件中，我们可以：
- 跟踪程序的执行流程，定位问题；
- 记录程序运行中的关键信息，方便后续的审计和排查问题；
- 分析程序运行的性能，找出瓶颈。
通过输出到 Log，我们可以更好地理解程序的运行情况，帮助我们更快地发现问题并进行处理。
Python 的 Logging 模块
Python 提供了 logging 模块用于输出日志信息。该模块提供了丰富的功能，可以自定义日志格式、级别、输出位置等。使用 logging 模块可以方便地进行日志记录。
以下是一个使用 logging 模块输出日志的简单示例：
import logging
# 创建一个日志记录器
logger = logging.getLogger('my_logger')
logger.setLevel(logging.DEBUG)
# 创建一个日志处理器，将日志输出到文件中
file_handler = logging.FileHandler('log.txt')
file_handler.setLevel(logging.DEBUG)
# 创建一个日志格式器
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
file_handler.setFormatter(formatter)
# 将日志处理器添加到日志记录器
logger.addHandler(file_handler)
# 输出不同级别的日志信息
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')
上述代码首先创建了一个日志记录器 logger，然后创建一个日志处理器 file_handler，并将其与日志记录器关联。接着，设置了日志的级别为 DEBUG，表示输出所有级别的日志信息。然后，设置了日志的输出格式。最后，通过 logger.debug、logger.info 等方法输出不同级别的日志信息。
通过运行上述代码，我们可以将日志信息输出到 log.txt 文件中，并且每一行的格式为 时间 - 记录器名称 - 日志级别 - 日志消息。
自定义日志级别
在上述示例中，我们使用了 logging.DEBUG、logging.INFO 等预定义的日志级别。实际应用中，我们也可以根据自己的需求定义自己的日志级别。
import logging
# 定义一个新的日志级别
MY_LOG_LEVEL = 25
logging.addLevelName(MY_LOG_LEVEL, 'MY')
logging.MY = MY_LOG_LEVEL
# 创建一个日志记录器
logger = logging.getLogger('my_logger')
logger.setLevel(logging.DEBUG)
# 创建一个日志处理器，将日志输出到文件中
file_handler = logging.FileHandler('log.txt')
file_handler.setLevel(logging.DEBUG)
# 创建一个日志格式器
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
file_handler.setFormatter(formatter)
# 将日志处理器添加到日志记录器
logger.addHandler(file_handler)
# 输出自定义级别的日志信息
logger.log(logging.MY, 'This is a custom log message')
上述代码定义了一个自定义的日志级别 MY_LOG_LEVEL，并通过 logging.addLevelName 方法为之指定了一个名称 MY。然后，我们可以通过 logger.log(logging.MY, 'message') 的方式输出自定义级别的日志信息。
序列图示例
下面是一个使用 logging 模块输出日志的序列图示例：
sequenceDiagram
participant App
participant Logger
participant FileHandler
App->>+Logger: 创建日志记录器
App->>+FileHandler: 创建日志处理器
loop 输出日志信息
App->>Logger: 输出日志信息
Logger-->>-FileHandler: 将日志信息传给处理器
FileHandler->>File: 写入日志文件
end
