### Python `logging` 模块参数详解 #### 日志级别 Python 的 `logging` 模块提供了多个日志级别，这些级别决定了消息的重要程度。以下是常见的日志级别及其对应的数值[^1]: - **DEBUG (10)**: 调试信息，通常只在诊断问题时使用。 - **INFO (20)**: 一般的信息性消息，表示程序正常运行。 - **WARNING (30)**: 表示可能发生潜在问题的消息，默认情况下会显示。 - **ERROR (40)**: 错误消息，表明某些功能无法正常工作。 - **CRITICAL (50)**: 致命错误消息，可能使整个程序崩溃。 可以通过设置不同的日志级别来控制哪些消息会被记录下来。例如，在生产环境中，可能会将日志级别设为 `WARNING` 或更高，以便减少不必要的输出。 #### 配置函数 `basicConfig` `logging.basicConfig()` 是用来配置根日志器的一个便捷方法。其主要参数如下[^1]: | 参数名 | 描述 | |----------------|----------------------------------------------------------------------------------------| | level | 设置最低的日志级别，低于此级别的日志不会被处理。(默认值： WARNING ) | | filename | 将日志写入指定文件而不是标准输出流。（可选） | | filemode | 文件打开模式 ('a' 追加, 'w' 覆盖)，仅当指定了filename时有效 | | format | 定义日志消息的格式化字符串 | | datefmt | 使用特定的时间格式化字符串 | | style | 支持三种占位符样式之一：%、{ 和 $ | 下面是一些常用的例子： ```python import logging # 自定义日志格式并保存到文件中 logging.basicConfig( level=logging.DEBUG, filename='app.log', filemode='w', format='%(asctime)s - %(levelname)s - %(message)s', datefmt='%Y-%m-%d %H:%M:%S' ) logging.debug("Debug Information") logging.info("Informational Message") ``` #### 创建自定义 Logger 对象 除了直接调用模块级函数外，还可以创建自己的 logger 实例以实现更精细的控制[^2]。通过这种方式可以针对应用程序的不同部分分别管理日志行为: ```python logger = logging.getLogger(__name__) # 获取当前模块名称作为Logger的名字 handler = logging.FileHandler('mylog.log') formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s') handler.setFormatter(formatter) logger.addHandler(handler) logger.setLevel(logging.INFO) logger.info('This will be logged into mylog.log.') ``` 以上代码片段展示了如何构建一个带有处理器和格式化的独立 Logger ，从而允许更加灵活地调整各个组件的行为特性。 ---