Python如何正确设置全局日志级别？替代内部调用配置的方案

针对你不想在Logger类内部硬依赖Settings、也不想每次调用getLogger时传debug参数的需求，下面提供几种实用方案：

方案1：程序启动时全局配置日志级别 #

直接在程序初始化阶段读取配置，设置全局日志级别，自定义Logger类不再单独处理级别逻辑，所有Logger实例自动继承全局设置，无需重复读取配置。

修改后的代码：

import logging

class Logger(logging.getLoggerClass()):
    def __init__(self, name):
        super().__init__(name)
        # 不再在初始化中硬编码读取配置，依赖全局设置

def setup_logging(debug_mode):
    # 程序启动时调用该方法，传入从Settings读取的debug模式
    root_logger = logging.getLogger()
    root_logger.setLevel(logging.DEBUG if debug_mode else logging.INFO)
    # 可按需配置日志格式、处理器
    formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
    console_handler = logging.StreamHandler()
    console_handler.setFormatter(formatter)
    root_logger.addHandler(console_handler)
    # 设置自定义Logger类为默认
    logging.setLoggerClass(Logger)

def getLogger(name):
    return logging.getLogger(name)

# 程序启动流程示例
if __name__ == "__main__":
    debug_mode = Settings().isDebugMode()
    setup_logging(debug_mode)
    # 后续创建的Logger自动使用全局级别
    logger = getLogger("my_app")
    logger.debug("调试信息")
    logger.info("普通信息")

方案2：给Logger类注入全局配置实例 #

通过类属性存储全局配置引用，程序启动时一次性注入，避免每个Logger实例重复创建Settings对象，同时解除类内部对Settings的硬依赖。

修改后的代码：

import logging

class Logger(logging.getLoggerClass()):
    # 类属性存储全局配置
    _global_settings = None

    def __init__(self, name):
        super().__init__(name)
        if self._global_settings is not None:
            debug_mode = self._global_settings.isDebugMode()
            self.setLevel(logging.DEBUG if debug_mode else logging.INFO)

    @classmethod
    def set_global_settings(cls, settings):
        cls._global_settings = settings

def getLogger(name):
    logging.setLoggerClass(Logger)
    return logging.getLogger(name)

# 程序启动流程示例
if __name__ == "__main__":
    settings = Settings()
    Logger.set_global_settings(settings)
    # 创建Logger时无需传参
    logger = getLogger("my_app")

方案3：利用logging模块字典配置（推荐） #

Python logging模块支持字典格式的统一配置，可将日志级别、格式、处理器等逻辑集中管理，自定义Logger类仅需继承默认类，无需自行处理级别逻辑。

示例代码：

import logging
import logging.config

class Logger(logging.getLoggerClass()):
    # 可添加自定义方法，无需处理级别逻辑
    pass

def setup_logging_from_dict():
    debug_mode = Settings().isDebugMode()
    log_config = {
        "version": 1,
        "disable_existing_loggers": False,
        "formatters": {
            "standard": {
                "format": "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
            }
        },
        "handlers": {
            "console": {
                "class": "logging.StreamHandler",
                "formatter": "standard",
                "level": "DEBUG" if debug_mode else "INFO"
            }
        },
        "root": {
            "handlers": ["console"],
            "level": "DEBUG" if debug_mode else "INFO"
        }
    }
    logging.config.dictConfig(log_config)
    logging.setLoggerClass(Logger)

def getLogger(name):
    return logging.getLogger(name)

# 程序启动流程示例
if __name__ == "__main__":
    setup_logging_from_dict()
    logger = getLogger("my_app")

方案优势对比 #

• 方案1：简单直接，适合小型项目，全局统一设置级别，Logger类改动最小。
• 方案2：保留Logger对配置的依赖但降低耦合，适合需要在Logger类中使用配置其他属性的场景。
• 方案3：符合logging模块设计规范，配置灵活度高，支持多处理器、多格式等复杂场景，适合中大型项目。

内容的提问来源于stack exchange，提问作者Mr. B.