Jupyter Notebook导入外部自定义类后logging日志无法显示如何解决

• Jupyter 环境启动时会自动初始化根日志器（root logger），预先添加了默认的输出 Handler。logging.basicConfig() 方法仅在根日志器无任何 Handler 时生效，因此你后续调用 basicConfig 修改日志级别、输出流的操作全部不会生效，这是最核心的原因。
• Jupyter 预设的根日志器 Handler 过滤级别为 WARNING，低于 WARNING 级别的日志（包括你代码中输出的 INFO 级别）会被直接过滤，不会输出到控制台。
• 如果你的操作顺序是先导入knowledge.knowledge_processor模块，再修改日志配置，也可能因配置生效时机滞后导致日志无法正常输出。

方案1：修改现有Handler级别（无需改动业务代码，推荐） #

在Notebook的最开头、导入业务模块之前执行以下配置代码即可：

import logging
# 获取根日志器
root_logger = logging.getLogger()
# 设置根日志器全局级别为INFO
root_logger.setLevel(logging.INFO)
# 批量修改所有已有Handler的过滤级别
for handler in root_logger.handlers:
    handler.setLevel(logging.INFO)

后续导入KnowledgeProcessor实例化时就可以正常看到INFO级别的日志输出。

方案2：给目标模块单独加Handler（不影响全局日志配置） #

如果不想修改全局日志规则，可以单独给knowledge_processor模块的日志器添加输出Handler：

import logging
# 直接导入业务模块中定义的logger实例
from knowledge.knowledge_processor import logger as k_logger

# 自定义控制台输出Handler
stream_handler = logging.StreamHandler()
stream_handler.setLevel(logging.INFO)
# 可自定义日志格式
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
stream_handler.setFormatter(formatter)

k_logger.addHandler(stream_handler)
k_logger.setLevel(logging.INFO)

# 再导入类实例化即可正常输出日志
from knowledge.knowledge_processor import KnowledgeProcessor
k = KnowledgeProcessor()

方案3：清空原有Handler后自定义配置（适合需要完全自定义日志格式的场景） #

如果需要完全自定义全局日志规则，可以先清空Jupyter预设的Handler，再调用basicConfig配置：

import logging
root_logger = logging.getLogger()
# 清空所有预设Handler
for handler in root_logger.handlers[:]:
    root_logger.removeHandler(handler)

# 此时basicConfig可以正常生效
logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
)

最佳实践建议：业务模块中不要直接获取根日志器logging.getLogger()，建议改为logging.getLogger(__name__)，可以按模块粒度控制日志输出，避免和全局日志配置产生冲突。

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