logging.basicConfig在__main__模块中未生效的原因咨询

问题描述 #

我正在开发一个Python包，其__main__.py包含如下代码：

import logging

def main():
    logging.basicConfig(level=logging.INFO)
    print(logging.getLogger(__name__))

if __name__ == "__main__":
    main()

执行命令python3 -m my_package后，输出结果为<Logger __main__ (ERROR)>，而非预期的INFO级别，导致日志消息无法显示。请问为何logging.basicConfig未生效？

原因分析 #

核心原因是**logging.basicConfig仅在日志系统未被初始化时生效**：

• 当使用python -m运行包时，Python会先导入包内的其他模块（若存在）。如果这些模块中提前执行了日志相关操作（比如调用logging.getLogger()、输出日志等），会触发日志系统的默认初始化——此时根Logger会被添加默认Handler，级别设为WARNING。
• 之后再调用logging.basicConfig时，因为日志系统已经完成初始化，它会直接跳过配置逻辑，不会修改现有级别。
• 另外，用-m运行时__main__.py中的__name__是__main__，你获取的Logger是根Logger的子Logger，它会继承根Logger的级别。如果根Logger被提前初始化为ERROR级别（比如某些第三方库或自定义模块修改过），就会出现你看到的结果。

解决办法 #

1. 提前配置日志 #

将logging.basicConfig放在代码最开头，确保在导入任何可能触发日志初始化的模块之前执行：

import logging
logging.basicConfig(level=logging.INFO)

def main():
    print(logging.getLogger(__name__))

if __name__ == "__main__":
    main()

2. 显式设置目标Logger级别 #

不依赖根Logger的配置，直接给当前Logger设置级别并添加Handler：

import logging

def main():
    logger = logging.getLogger(__name__)
    logger.setLevel(logging.INFO)
    # 添加默认输出Handler
    handler = logging.StreamHandler()
    formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
    handler.setFormatter(formatter)
    logger.addHandler(handler)
    print(logger)
    # 测试日志
    logger.info("这条INFO日志能正常显示了")

if __name__ == "__main__":
    main()

3. 重置日志系统（不推荐） #

如果必须在日志初始化后修改配置，可以强制清空根Logger的Handler后重新配置：

import logging

def main():
    # 移除根Logger的所有现有Handler
    for handler in logging.root.handlers[:]:
        logging.root.removeHandler(handler)
    # 重新配置
    logging.basicConfig(level=logging.INFO)
    print(logging.getLogger(__name__))

if __name__ == "__main__":
    main()

内容的提问来源于stack exchange，提问作者shikhanshu