本文介绍当第三方库（如 pdf2docx）直接使用 logging.info() 等顶层函数而非命名 logger 时，如何全局抑制其冗余日志输出——通过配置根日志器（root logger）实现静默控制。
本文介绍当第三方库（如 `pdf2docx`）直接使用 `logging.info()` 等顶层函数而非命名 logger 时，如何全局抑制其冗余日志输出——通过配置根日志器（root logger）实现静默控制。
在 Python 中，logging 模块提供了两种常见日志调用方式：一种是通过显式获取命名 logger（如 logger = logging.getLogger(__name__)），另一种是直接调用顶层函数（如 logging.info("msg")）。后者本质上等价于对根日志器（root logger） 的操作，即 logging.getLogger()（无参数）返回的对象。
因此，当 pdf2docx 等包在其 converter 模块中直接调用 logging.basicConfig(level=logging.INFO) 并随后执行 logging.info(...) 时，这些日志均由根日志器处理并默认向 sys.stderr 输出。此时，仅设置自定义 logger 的级别或禁用特定模块 logger 是无效的——因为它们并未被使用。
✅ 正确的解决方法是显式接管并禁用根日志器：
import logging
# 禁用根日志器：阻止所有直接 logging.*() 调用的输出
root_logger = logging.getLogger() # 等价于 logging.getLogger("")
root_logger.disabled = True
root_logger.propagate = False
⚠️ 注意事项：
- 必须在导入并触发日志输出的第三方模块之前执行上述代码（例如，在
import pdf2docx前），否则其basicConfig可能已激活根日志器并建立 handler；- 若项目中其他部分仍需使用根日志器（如主程序日志），建议改用命名 logger（推荐实践），并避免依赖
logging.info()全局调用；- 替代方案（更精细控制）：可将根日志器级别设为
CRITICAL或添加空Handler，但disabled = True是最简洁、彻底的静默方式。
总结：直接调用 logging.info() 并非“无法控制”，而是因其绑定根日志器——只要在日志产生前正确配置根日志器，即可可靠屏蔽所有此类第三方日志，无需修改依赖源码或打补丁。
