Python logging库中调用setLevel设置默认级别是否为规范实践？

明确结论 #

在编写Python库时，不建议在库内调用logger.setLevel()，这属于不良实践。

核心原因 #

• 日志系统的层级继承逻辑已自带默认行为：根日志器默认级别为WARNING，库的日志器会自动继承祖先（包括根日志器）的级别。库自行设置级别会打破这种约定，让使用者困惑——比如使用者明明配置了全局日志为DEBUG，却发现库只输出INFO及以上日志，排查起来十分麻烦。
• 库的级别设置会干扰应用配置：如果应用程序先通过配置文件或代码完成了日志系统的全局配置，后续导入库时，库内的setLevel()会直接修改对应日志器的级别，导致应用的配置失效，出现日志输出不符合预期的混乱。

对三种观点的分析 #

• 观点(A)：“应用广泛”不等于“符合最佳实践”。不少早期库可能沿用了这种写法，但这并不代表它是正确的，反而会给使用者带来不必要的困扰。
• 观点(B)：完全契合Python日志框架的设计初衷，精准指出了库自行设置级别带来的核心问题——破坏继承逻辑、干扰应用配置。
• 观点(C)：“显式优于隐式”的原则不适用于此场景，日志级别属于应用层面的配置项，而非库自身的功能逻辑，库应该把日志级别的控制权完全交给使用它的应用程序。

库的正确日志写法 #

库只需要获取对应名称的日志器即可，无需设置级别：

"""library module"""
import logging
logger = logging.getLogger(__name__)

# 直接使用日志方法，级别由应用配置决定
logger.info('milepost')

这样应用程序可以通过配置根日志器或该库对应的日志器级别，完全控制日志输出，不会被库的设置干扰。

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