多模块日志配置与输出设置方法

本文深入讲解了如何利用 Python 的 logging 模块为多模块项目实现精细化日志管理——通过为每个模块（如 database、api）创建独立命名的 logger，分别配置专属 FileHandler、自定义日志级别，并设置 propagate=False 避免日志重复和 root logger 干扰，最终达成“不同模块按需输出不同级别日志到不同文件”的灵活效果；同时推荐使用 dictConfig 进行集中化、可维护的声明式配置，大幅提升大型项目的日志可读性与运维效率。

可以通过 Python 的 logging 模块为不同模块配置独立的 logger，并分别设置日志级别和输出目标（如文件），实现“不同模块输出不同级别日志到不同文件”的效果。关键在于避免使用 root logger，而是为每个模块创建命名 logger，并单独配置 handler 和 level。

为每个模块创建独立命名 logger

在各模块中调用 logging.getLogger(__name__) 获取专属 logger。模块名（如 "database"、"api"）会自动成为 logger 名称，便于区分和单独配置。

• 模块 database.py 中写：
    logger = logging.getLogger("database")
• 模块 api.py 中写：
    logger = logging.getLogger("api")
• 不调用 logging.basicConfig()，否则会干扰自定义配置

为每个 logger 单独添加 FileHandler 并设级别

在主程序或配置模块中，为每个命名 logger 分别添加 handler，并设置其 level（注意：handler 有 level，logger 自身也有 level，两者都需满足才会输出）。

• 给 "database" logger 添加 DEBUG 级别文件 handler：
    db_logger = logging.getLogger("database")
    db_handler = logging.FileHandler("db_debug.log")
    db_handler.setLevel(logging.DEBUG)
    db_logger.addHandler(db_handler)
    db_logger.setLevel(logging.DEBUG)
• 给 "api" logger 添加 WARNING 级别文件 handler：
    api_logger = logging.getLogger("api")
    api_handler = logging.FileHandler("api_warning.log")
    api_handler.setLevel(logging.WARNING)
    api_logger.addHandler(api_handler)
    api_logger.setLevel(logging.WARNING)

避免日志重复和 root logger 干扰

默认情况下，logger 会向父 logger（最终是 root）传播日志。若不控制，日志可能同时写入多个文件或控制台。

• 在每个自定义 logger 上设置 propagate = False：
    db_logger.propagate = False
    api_logger.propagate = False
• 确保 root logger 未被意外启用（例如没调用 basicConfig，或显式禁用：
    logging.getLogger().setLevel(logging.CRITICAL)
    logging.getLogger().handlers.clear()

可选：统一配置入口（推荐用 dictConfig）

将所有 logger、handler、level 配置写成字典，用 logging.config.dictConfig() 一次性加载，更清晰、易维护。

• 示例片段：
    config = {
      "version": 1,
      "loggers": {
        "database": {"level": "DEBUG", "handlers": ["db_file"], "propagate": false},
        "api": {"level": "WARNING", "handlers": ["api_file"], "propagate": false}
      },
      "handlers": {
        "db_file": {"class": "logging.FileHandler", "filename": "db_debug.log", "level": "DEBUG"},
        "api_file": {"class": "logging.FileHandler", "filename": "api_warning.log", "level": "WARNING"}
      }
    }
• 调用：
    logging.config.dictConfig(config)

本篇关于《多模块日志配置与输出设置方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！