当第三方库（如 pdf2docx）直接使用 logging.info() 等顶层函数而非模块级 logger 时，其日志会流向 root logger；通过禁用并阻止传播根日志器，可全局屏蔽此类干扰日志。
当第三方库（如 `pdf2docx`）直接使用 `logging.info()` 等顶层函数而非模块级 logger 时，其日志会流向 root logger；通过禁用并阻止传播根日志器，可全局屏蔽此类干扰日志。
在 Python 中，logging 模块的顶层函数（如 logging.debug()、logging.info()）本质上是向 root logger 发送日志事件。若某包（例如 pdf2docx/converter.py）未显式创建 logger = logging.getLogger(__name__)，而是直接调用 logging.info("...")，则这些日志将由 root logger 处理——而默认情况下，root logger 的级别为 WARNING，且一旦调用过 logging.basicConfig()（如该包内部所做），其级别可能被设为 INFO 并附加了 StreamHandler，导致大量冗余输出污染控制台。
✅ 正确且简洁的解决方案是：显式获取并配置 root logger，使其静默：
import logging
# 获取空字符串名的 logger —— 即 root logger
root_logger = logging.getLogger("")
root_logger.disabled = True # 彻底禁用日志分发（优先级高于 level 设置）
root_logger.propagate = False # 防止向上级（如已存在的 handlers）传递
⚠️ 注意事项：
- 必须在导入并触发日志输出的第三方模块之前执行上述代码（例如，在
import pdf2docx前），否则其内部basicConfig()或首次日志调用可能已初始化 root logger 并添加 handler； - 若项目中其他部分仍需 root logger 功能，建议改用
logging.getLogger(__name__)规范记录，并通过logging.getLogger("pdf2docx").setLevel(logging.WARNING)精准抑制特定包日志，而非全局禁用； -
disabled = True是最彻底的方式（比setLevel(logging.CRITICAL + 1)更可靠），因为它绕过所有级别判断和处理器遍历。
? 补充技巧：若只想临时屏蔽（如单元测试中），可结合上下文管理器封装：
import logging
from contextlib import contextmanager
@contextmanager
def suppress_root_logging():
root = logging.getLogger("")
original_disabled = root.disabled
original_propagate = root.propagate
try:
root.disabled = True
root.propagate = False
yield
finally:
root.disabled = original_disabled
root.propagate = original_propagate
# 使用示例
with suppress_root_logging():
import pdf2docx # 此时其内部 logging.* 调用将完全静默
# ... 执行转换逻辑
综上，直接调用 logging 并非“无法抑制”，而是需理解其底层依赖 root logger 的机制——精准干预 root logger，即可干净、可控地消除第三方库的日志噪音。
