### Python 中 Logger 类的常规用法及功能解释 #### 1. **Logger 类的作用** `Logger` 是 `logging` 模块的核心组件之一，用于创建日志记录器实例。通过该类可以定义不同级别的日志消息（如 DEBUG、INFO、WARNING、ERROR 和 CRITICAL），并将其发送到不同的目标位置（如控制台或文件）。其主要职责是提供灵活的日志记录机制[^3]。 --- #### 2. **Logger 类的基本属性和方法** 以下是 `Logger` 类的一些重要属性和方法： - **setLevel(level)** 设置日志记录级别，只有高于此级别的日志才会被处理。例如，如果设置了 `DEBUG` 级别，则所有的日志都会被捕获；而如果是 `ERROR` 级别，则只会捕获 ERROR 和 CRITICAL 日志[^1]。 - **debug(msg, *args, **kwargs)** 记录一条调试信息，默认等级为 `DEBUG`。 - **info(msg, *args, **kwargs)** 记录一条普通信息，默认等级为 `INFO`。 - **warning(msg, *args, **kwargs)** 记录警告信息，默认等级为 `WARNING`。 - **error(msg, *args, **kwargs)** 记录错误信息，默认等级为 `ERROR`。 - **critical(msg, *args, **kwargs)** 记录严重错误信息，默认等级为 `CRITICAL`。 - **addHandler(hdlr)** 添加一个新的日志处理器（Handler），以便将日志输出到指定的目标位置，比如文件或者网络流[^2]。 - **removeHandler(hdlr)** 移除已有的日志处理器。 --- #### 3. **Logger 配置示例** 下面展示如何配置一个简单的 `Logger` 实例，并使用它来记录不同类型的消息。 ```python import logging # 创建 logger 对象 logger = logging.getLogger('example_logger') logger.setLevel(logging.DEBUG) # 创建 handler 并设置 level console_handler = logging.StreamHandler() file_handler = logging.FileHandler('app.log') console_handler.setLevel(logging.INFO) file_handler.setLevel(logging.ERROR) # 创建 formatter 并附加给 handler formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s') console_handler.setFormatter(formatter) file_handler.setFormatter(formatter) # 将 handler 绑定到 logger 上 logger.addHandler(console_handler) 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.') ``` 上述代码中： - 控制台只显示 INFO 及以上级别的日志； - 文件仅存储 ERROR 和 CRITICAL 级别的日志。 --- #### 4. **与其他工具集成** 除了原生的 `logging` 模块外，还可以借助第三方库扩展日志功能。例如，`Loguru` 提供了一个更简洁的 API 来替代传统的 `Logger` 配置方式。以下是一个基于 Loguru 的简单实现： ```python from loguru import logger # 自动记录日志至文件并支持轮转 logger.add("logs/app_{time}.log", rotation="500 MB") # 输出日志 logger.debug("Debugging information.") logger.info("Informational message.") logger.warning("Warning occurred.") logger.error("An error happened.") logger.critical("Critical issue detected!") ``` --- #### 5. **注意事项** 当使用断言语句 (`assert`) 进行测试时需要注意，在生产环境中运行 `-O` 参数优化模式下，所有 `assert` 表达式会被忽略。因此不建议依赖 `assert` 执行关键逻辑验证，而是推荐利用 `Logger` 或其他异常处理手段完成类似的检查工作[^5]。 --- ###