python logging 模块 日志记录 异常处理 调试
1. 日志记录级别
日志记录级别指定了哪些事件应记录。从最低级别到最高级别，这些级别包括：
- DEBUG
- INFO
- WARNING
- ERROR
- CRITICAL
使用 logging.basicConfig() 函数设置日志记录级别，例如：
立即学习“Python免费学习笔记（深入）”；
import logging logging.basicConfig(level=logging.INFO)
2. 日志记录处理器
处理器定义了日志记录消息应如何处理。一些常用的处理器包括：
- StreamHandler：将日志记录消息打印到控制台或文件
- FileHandler：将日志记录消息写入文件
- SMTPHandler：将日志记录消息通过电子邮件发送
import logging
# 将日志记录消息打印到控制台
stdout_handler = logging.StreamHandler()
stdout_handler.setLevel(logging.WARNING)
# 将日志记录消息写入文件
file_handler = logging.FileHandler("log.txt")
file_handler.setLevel(logging.DEBUG)
# 将日志记录消息通过电子邮件发送
smtp_handler = logging.SMTPHandler("localhost", "info@example.com", "sender@example.com", "Subject: Log Alert")
smtp_handler.setLevel(logging.ERROR)
# 添加处理器到根记录器
logging.getLogger().addHandler(stdout_handler)
logging.getLogger().addHandler(file_handler)
logging.getLogger().addHandler(smtp_handler)
3. 日志记录格式器
格式器定义了日志记录消息的格式。可以使用 logging.FORMatter 类来创建自定义格式器，例如：
import logging
# 创建一个自定义格式器
formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
# 设置格式器到处理器
for handler in logging.getLogger().handlers:
handler.setFormatter(formatter)
4. 异常处理
logging 模块可以方便地记录异常：
import logging
try:
# 执行可能引发异常的代码
except Exception:
# 记录异常
logging.exception("An error occurred")
5. 调试
logging 模块还可以帮助调试：
- 使用
logging.debug()函数记录调试信息，例如：
import logging
# 记录调试信息
logging.debug("Current value of x: %d", x)
- 使用
logging.getLogger(name).setLevel(level)修改特定记录器的级别，例如：
import logging
# 将 "my_module" 记录器的日志记录级别设置为 DEBUG
logging.getLogger("my_module").setLevel(logging.DEBUG)
6. 最佳实践
使用 logging 模块的一些最佳实践包括：
- 始终设置日志记录级别
- 使用有意义的日志记录消息
- 使用格式器定义自定义日志记录格式
- 跟踪异常
- 使用调试信息进行故障排除
结论
Python logging 模块是一个强大的工具，可以帮助开发人员记录事件、调试问题和跟踪异常。通过理解其概念和利用其功能，开发人员可以大幅增强其项目的日志记录功能。
