如何在可复用Python包中实现日志功能？

核心原则：包只负责打日志，主程序统一管配置 #

完全不需要在包内做任何日志初始化配置（比如调用logging.basicConfig），只需要在包的每个模块里获取对应层级的logger直接打日志，主程序会统一接管所有日志的样式、级别。

包内日志的正确写法 #

在包的每个模块中，用logging.getLogger(__name__)获取当前模块的logger，这个logger会自动继承主程序的配置，还能在日志里明确区分出是哪个包/模块输出的内容：

# 你的包模块：mypackage/helper.py
import logging

# __name__会自动解析为"mypackage.helper"，自带包层级标识
logger = logging.getLogger(__name__)

def process_data(data):
    logger.debug(f"开始处理数据：{data}")
    # 业务逻辑代码...
    logger.info("数据处理完成")
    logger.warning("处理过程中发现非致命异常")

主程序的统一配置 #

主程序里只需要做一次日志配置，所有导入的包都会自动遵循这个配置，不用修改包的任何代码：

# 主应用：main.py
import logging
from mypackage import helper

# 主程序统一设置日志级别、格式、输出渠道
logging.basicConfig(
    level=logging.DEBUG,
    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
    filename="app.log"  # 可输出到文件，默认输出到控制台
)

helper.process_data({"key": "value"})

进阶：给包加默认日志兜底（可选） #

如果担心主程序完全没配置日志，导致包的日志根本看不到，可以在包的__init__.py里加个简单的兜底逻辑——只在包的logger没有任何处理器时，添加一个默认处理器，不会干扰主程序的配置：

# mypackage/__init__.py
import logging

package_logger = logging.getLogger(__name__)

if not package_logger.handlers:
    # 添加默认控制台处理器
    handler = logging.StreamHandler()
    handler.setFormatter(logging.Formatter("%(levelname)s [%(name)s]: %(message)s"))
    package_logger.addHandler(handler)
    # 默认只输出警告及以上级别，避免调试信息泛滥
    package_logger.setLevel(logging.WARNING)

关键原理 #

Python的logging模块是层级结构的，__name__对应的logger会继承父级（比如mypackage继承根logger）的配置。主程序配置根logger后，所有子logger都会自动应用这些配置，包括级别、格式、处理器，以此实现主程序统一控制所有包的日志行为。

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