Python logging 模块：专家级教程，从入门到精通

百变鹏仔 2天前 #Python

文章标签模块

简介

logging 模块是 python 中用于日志记录的标准库。它提供了对应用程序中事件进行日志记录的统一界面，并允许开发人员定义日志级别的细粒度控制、格式化日志消息以及将日志输出到各种目标（例如文件、控制台或网络套接字）。

要开始日志记录，首先需要创建一个 logger 对象。logger 可以通过 logging.getLogger(name) 函数创建，其中 name 是一个标识符字符串，用于识别logger。

import logging# 创建一个名为 "my_logger" 的 loggerlogger = logging.getLogger("my_logger")

可以使用 logger.log(level, msg, *args, **kwargs) 方法记录日志消息，其中：

logger.info("程序已启动")logger.error("发生错误！")

logging 模块定义了以下日志级别（从最低到最高）：

立即学习“Python免费学习笔记（深入）”；

可以将日志级别设置为 logger.level 属性。例如，要将 my_logger 的级别设置为 WARNING，可以使用：

logger.level = logging.WARNING

格式化器用于控制日志消息的外观。可以通过 logging.FORMatter 类创建格式化器，它具有以下参数：

# 创建一个格式化器，包含时间戳、日志级别和日志消息formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")

处理器用于将日志消息输出到特定目标。logging 模块提供了一些开箱即用的处理器，例如：

# 创建一个处理器，将日志消息输出到控制台handler = logging.StreamHandler()# 将格式化器添加到处理器handler.setFormatter(formatter)# 将处理器添加到 loggerlogger.addHandler(handler)

过滤器用于根据特定条件筛选日志消息。logging 模块提供了以下过滤器：

# 创建一个过滤器，仅允许 INFO 和 WARNING 级别的日志消息filter = logging.LevelFilter(logging.INFO)# 将过滤器添加到处理器handler.addFilter(filter)

Python logging 模块支持层次结构日志记录，其中 logger 可以继承其父 logger 的属性和行为。这允许建立一个具有不同级别的日志细粒度的日志记录结构。

还可以创建自定义日志记录级别，以便更好地适应应用程序的特定需求。这可以通过 logging.addLevelName(level_name, level_value) 函数实现。

可以通过自定义类和函数扩展 logging 模块，以实现更高级或特定的日志记录功能。例如，可以创建自己的处理器或过滤器来满足特定要求。

Python logging 模块是一个强大的工具，用于应用程序中的日志记录。它提供了灵活性和可定制性，允许开发人员根据应用程序的特定需求构建日志记录系统。通过遵循本教程中概述的基本原则和高级技术，可以最大限度地利用 logging 模块，并为应用程序实现高效且信息丰富的日志记录。

文章推荐