python logger（记录器）

一、什么是 logger（记录器）？

• logger（记录器）是 Python logging 模块的核心对象，用于产生日志。
• 你可以创建多个 logger，每个 logger 可以有不同的名字、日志级别、处理器（Handler）和格式（Formatter）。
• logger 负责接收日志消息，并将其分发给一个或多个 Handler 进行实际输出。

二、logger 的常用方法

1. getLogger([name]) —— 创建或获取记录器

• 作用：创建一个新的 logger，或获取一个已存在的 logger。
• 参数：
  • name：logger 的名字（字符串）。如果不传，返回根记录器（root logger）。
• 示例：

  logger1 = logging.getLogger()           # 获取根记录器
  logger2 = logging.getLogger('mylogger') # 获取名为'mylogger'的记录器
  

2. setLevel(level) —— 设置日志等级

• 作用：设置 logger 的日志级别，只有大于等于该级别的日志才会被处理。
• 参数：level 可以是 logging.DEBUG、logging.INFO 等。
• 示例：

  logger.setLevel(logging.INFO)
  

3. addHandler(handler) —— 添加处理程序

• 作用：为 logger 添加一个 Handler（处理器），决定日志输出到哪里、以什么格式输出。
• 参数：handler 是一个 Handler 对象，如 StreamHandler、FileHandler 等。
• 示例：

  handler = logging.StreamHandler()
  logger.addHandler(handler)
  

4. removeHandler(handler) —— 移除处理程序

• 作用：从 logger 中移除一个 Handler。
• 参数：handler 是要移除的 Handler 对象。
• 示例：

  logger.removeHandler(handler)
  

三、logger 的使用流程

1. 获取 logger（getLogger）
2. 设置日志级别（setLevel）
3. 添加 Handler（addHandler），可设置不同的输出目标和格式
4. 输出日志（如 logger.info()、logger.error() 等）

四、你的代码详解

import logging

logger = logging.getLogger()

• 这行代码获取了根记录器（root logger）。
• 你可以用 logger 来输出日志，也可以为它添加 Handler、设置日志级别等。

五、logger 与 Handler 的关系

• logger 负责产生日志，Handler 负责处理日志（如输出到文件、控制台等）。
• 一个 logger 可以有多个 Handler，每个 Handler 可以有不同的输出目标和格式。

六、完整示例

import logging

# 1. 获取记录器
logger = logging.getLogger('mylogger')

# 2. 设置日志级别
logger.setLevel(logging.DEBUG)

# 3. 创建并添加 Handler
console_handler = logging.StreamHandler()
file_handler = logging.FileHandler('app.log', encoding='utf-8')

# 4. 设置不同格式
console_format = logging.Formatter('%(levelname)s: %(message)s')
file_format = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')

console_handler.setFormatter(console_format)
file_handler.setFormatter(file_format)

logger.addHandler(console_handler)
logger.addHandler(file_handler)

# 5. 输出日志
logger.info('普通信息')
logger.error('错误信息')

# 6. 移除 Handler
logger.removeHandler(console_handler)

七、总结

• logger 是日志系统的核心，负责产生日志并分发给 Handler。
• 通过 getLogger 获取 logger，通过 setLevel 设置级别，通过 addHandler/removeHandler 管理输出目标。
• 灵活配置 logger 和 Handler，可以满足各种复杂的日志需求。
  ！