Python - 日志记录
你好，有抱负的Python程序员们！今天，我们将深入探讨Python中的日志记录这一奇妙世界。作为你们友好邻居般的计算机教师，我很兴奋能引导你们完成这次学习之旅。相信我，在本教程结束时，你们将会像专业人士一样进行日志记录！
Python中的日志记录
想象一下，你是一名侦探，正在努力解决一个谜题。你会想要记录下你找到的所有线索，对吧？嗯，编程中的日志记录做的就是这件事！它帮助我们跟踪代码运行时发生的事情。
Python内置了一个logging模块，使得这个过程变得非常简单。这就像拥有一个可靠的笔记本，它会自动为你记录下重要信息。
日志记录的好处
现在，你可能会想，“我可以用打印语句，为什么还要费心日志记录呢？”好问题！让我分享一个我早期编程时的小故事。
我曾经花了几小时用打印语句来调试一个程序。这就像在大海里捞针一样！然后我发现了日志记录的魔力。以下是一些好处：
- 灵活性：与打印语句不同，日志可以轻松地开启或关闭，而无需修改代码。
- 严重性级别：你可以根据重要性对日志进行分类。
- 输出控制：日志可以被重定向到文件、控制台，甚至是远程服务器！
- 性能：与打印语句相比，日志记录对性能的影响较小。
Python日志记录的组件
让我们分解一下Python日志记录的主要组件：
- 日志记录器：这些是进入日志系统的入口点。
- 处理器：它们将日志记录发送到适当的目的地。
- 格式化器：它们指定日志记录在最终输出中的布局。
- 过滤器：这些提供了对哪些日志记录输出的额外控制。
把它想象成一个工厂的装配线。日志记录器是发现问题的工人，处理器决定将报告发送到哪里，格式化器决定报告应该是什么样子，而过滤器决定哪些报告足够重要以传递下去。
日志记录级别
Python日志记录带有五个标准的严重性级别。让我们在下面的表中看看它们：
| 级别 | 数值 | 描述 |
|---|---|---|
| DEBUG | 10 | 详细信息，通常仅在诊断问题时感兴趣。 |
| INFO | 20 | 确认事情按预期工作。 |
| WARNING | 30 | 表示发生了意外，或者预示着不久的将来会有问题。 |
| ERROR | 40 | 由于更严重的问题，软件未能执行某些功能。 |
| CRITICAL | 50 | 一个严重的错误，表明程序本身可能无法继续运行。 |
基本日志记录示例
让我们从一个简单的例子开始：
import logging
# 配置基本日志记录
logging.basicConfig(level=logging.INFO)
# 创建一个日志记录器
logger = logging.getLogger(__name__)
# 记录一些消息
logger.debug("这是一个调试消息")
logger.info("这是一个信息消息")
logger.warning("这是一个警告消息")
logger.error("这是一个错误消息")
logger.critical("这是一个严重消息")如果你运行这段代码，你会看到类似以下输出：
INFO:__main__:这是一个信息消息
WARNING:__main__:这是一个警告消息
ERROR:__main__:这是一个错误消息
CRITICAL:__main__:这是一个严重消息注意DEBUG消息没有出现吗？那是因为我们设置了基本的配置级别为INFO。任何低于INFO的（比如DEBUG）都不会被记录，除非我们改变配置。
配置日志记录
现在，让我们对日志记录配置进行一些高级设置：
import logging
# 配置日志记录
logging.basicConfig(
level=logging.DEBUG,
format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
filename='app.log'
)
logger = logging.getLogger(__name__)
logger.debug("调试消息")
logger.info("信息消息")
logger.warning("警告消息")
logger.error("错误消息")
logger.critical("严重消息")在这个例子中，我们做了以下设置：
- 将日志记录级别设置为DEBUG
- 指定日志消息的格式
- 将输出重定向到名为'app.log'的文件
如果你检查'app.log'文件，你会看到带有时间戳的格式化日志消息！
日志记录处理器
处理器就像是日志世界中的邮政服务。它们决定你的日志消息最终去往何处。让我们看一个使用多个处理器的例子：
import logging
# 创建一个日志记录器
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)
# 创建处理器
c_handler = logging.StreamHandler() # 控制台处理器
f_handler = logging.FileHandler('file.log') # 文件处理器
c_handler.setLevel(logging.WARNING)
f_handler.setLevel(logging.ERROR)
# 创建格式化器并将其添加到处理器
c_format = logging.Formatter('%(name)s - %(levelname)s - %(message)s')
f_format = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
c_handler.setFormatter(c_format)
f_handler.setFormatter(f_format)
# 将处理器添加到日志记录器
logger.addHandler(c_handler)
logger.addHandler(f_handler)
# 测试日志记录器
logger.debug('这是一个调试消息')
logger.info('这是一个信息消息')
logger.warning('这是一个警告消息')
logger.error('这是一个错误消息')
logger.critical('这是一个严重消息')在这个例子中，我们设置了两个处理器：
- 一个StreamHandler，将WARNING及以上的消息输出到控制台
- 一个FileHandler，将ERROR及以上的消息记录到文件中
运行这段代码，你会在控制台看到WARNING及以上的消息，而只有ERROR和CRITICAL消息会被保存到文件中。
就这样，各位！你们刚刚迈出了Python日志记录世界的第一步。记住，熟能生巧。尝试不同的配置，看看哪种最适合你的项目。
快乐记录日志，愿你的代码永远无bug！
Credits: Image by storyset