如何在 Python 项目中跨模块共享日志记录器实例

通过 builtins 模块将日志记录器（如 logging.getLogger(__name__)）设为全局可访问对象，可在任意模块中直接使用，无需重复导入或传递实例。

通过 `builtins` 模块将日志记录器（如 `logging.getlogger(__name__)`）设为全局可访问对象，可在任意模块中直接使用，无需重复导入或传递实例。

在 Python 中，模块级对象默认具有模块作用域，无法被其他模块直接访问。若希望在多个模块间共享一个统一的日志记录器实例（例如避免重复配置、确保日志上下文一致），最简洁且可行的方案之一是利用 builtins 模块——它提供了一个全局命名空间，所有模块均可读取其中的变量。

具体做法如下：

1. 在主初始化模块（如 __init__.py 或 main.py）中定义并注入全局 logger：

import builtins
import logging

# 配置日志格式与级别（建议在此统一设置）
logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
)

# 创建并绑定到 builtins
_logger = logging.getLogger("myapp")
builtins.LOGGER = _logger

2. 在任意其他模块中直接使用：

# utils.py 或 api.py 等任意模块
def do_something():
    LOGGER.info("This log appears with consistent configuration.")

✅ 优势：

• 无需参数传递或单例类封装；
• 所有模块通过 LOGGER 即可获取同一实例，保证日志输出行为一致；
• 兼容标准 logging 模块的所有方法（.info(), .error(), .debug() 等）。

⚠️ 注意事项：

立即学习“Python免费学习笔记（深入）”；

• builtins 是 Python 内置命名空间，滥用可能导致命名冲突（如避免使用 builtins.logger 这类通用名，推荐 builtins.LOGGER 等大写常量风格）；
• 该方式适用于中小型项目或快速原型开发；大型项目更推荐依赖注入或应用上下文管理（如 Flask 的 current_app.logger 或自定义 AppContext）；
• 确保 builtins.LOGGER 在任何其他模块导入前已被赋值（通常放在项目入口或包初始化文件中）。

总结：借助 builtins 实现跨模块 logger 共享是一种轻量、有效且符合 Python 动态特性的实践方案，关键在于合理初始化时机与命名规范。