Python两个模块统一日志级别：调用模块时basicConfig配置无效的问题求助

嘿，这个坑我之前也踩过！其实是Python logging 模块的一个容易忽略的特性搞的鬼——basicConfig() 函数只会在根 logger 还没有绑定任何处理器（handler）的时候才会生效。

咱们来掰扯掰扯两种执行场景的差异：

• 直接跑 test.py：这时候脚本是作为主模块启动的，根 logger 完全没被配置过，所以调用 basicConfig(level=level) 会乖乖创建默认的控制台处理器，同时设置好日志级别，输出自然符合预期。
• 跑 dscc.py：当你从 my_package 导入 test 模块时，Python 会先加载 test.py 的代码（包括创建那个模块级的 logger），但这时候还没调用 test.main()。可问题在于，如果在导入 test 之前，你的项目环境（比如 my_package 里的其他模块、甚至Python启动时的隐式日志初始化）已经给根 logger 加过处理器了，那等你在 test.main() 里调用 basicConfig 时，它会直接跳过配置——因为根 logger 已经有处理器了，这就导致你的级别设置完全没用。

靠谱的解决方案有这几个，你按需选： #

方案1：直接操作根logger（最稳妥） #

别依赖 basicConfig 的隐式逻辑，直接上手根logger，确保它有处理器的同时设置级别：
修改 test.py 的 main 函数：

def main(level='INFO') -> None:
    # 拿到根logger
    root_logger = getLogger()
    # 如果根logger还没处理器，就用basicConfig初始化一个默认的
    if not root_logger.handlers:
        basicConfig()
    # 直接给根logger设级别
    root_logger.setLevel(level)
    logger.info('This is a test')

方案2：给模块级logger单独设级别 #

你的 logger 是模块级的（getLogger(__name__)），它默认继承根logger的级别。所以可以直接给它设级别，同时确保根logger能输出对应日志：

def main(level='INFO') -> None:
    # 先确保根logger有处理器（没的话就初始化）
    if not getLogger().handlers:
        basicConfig()
    # 给当前模块的logger设置级别
    logger.setLevel(level)
    logger.info('This is a test')

方案3：统一在入口初始化日志（项目规范做法） #

如果你的项目有多个模块，最好在入口脚本（比如 dscc.py）里统一配置日志，其他模块只负责创建自己的logger就行：
先改 dscc.py：

from logging import basicConfig
from my_package import test

def main() -> None:
    """ Main function. """
    # 入口处统一初始化日志配置
    basicConfig(level='WARNING')
    test.main()

if __name__ == '__main__':
    main()

再改 test.py，去掉里面的 basicConfig 调用：

# test.py 
from logging import getLogger
logger = getLogger(__name__) 

def main(level='INFO') -> None: 
    # 要么给模块logger设级别，要么直接用根logger的级别
    logger.setLevel(level)
    logger.info('This is a test') 

if __name__ == '__main__': 
    from logging import basicConfig
    basicConfig(level='WARNING')
    main() 

这样改完之后，不管是直接运行 test.py 还是通过 dscc.py 调用，日志级别都能正常生效啦！

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