通过 Python 的 builtins 模块可将日志记录器对象注入全局命名空间，使其在项目任意模块中无需重复导入或传递即可直接访问。这是一种轻量级的跨模块单例式共享方案。
通过 python 的 `builtins` 模块可将日志记录器对象注入全局命名空间，使其在项目任意模块中无需重复导入或传递即可直接访问。这是一种轻量级的跨模块单例式共享方案。
在大型 Python 项目中，常需在多个模块中统一使用同一个日志记录器（logging.Logger 实例），以确保日志格式、级别和处理器的一致性。虽然可通过依赖注入、配置中心或单例类等方式实现，但若追求简洁且不引入额外架构，利用 builtins 模块是一种直接有效的方案。
builtins 是 Python 的内置命名空间，其内容对所有模块全局可见（类似 print、len 等内置函数）。我们可以将配置好的 Logger 实例赋值给一个自定义的内置变量名，从而实现跨模块免导入访问：
# logger_setup.py
import builtins
import logging
# 创建并配置 logger（推荐使用 __name__ 作为名称，便于追踪来源）
_logger = logging.getLogger("myapp")
_logger.setLevel(logging.INFO)
handler = logging.StreamHandler()
formatter = logging.Formatter("[%(levelname)s] %(name)s: %(message)s")
handler.setFormatter(formatter)
_logger.addHandler(handler)
# 注入全局命名空间
builtins.LOGGER = _logger
随后，在任意其他模块中可直接使用：
# module_a.py
def do_something():
LOGGER.info("This log appears with consistent formatting") # ✅ 无需 import logging 或 getLogger
# module_b.py
import requests
def fetch_data():
try:
resp = requests.get("https://httpbin.org/get")
LOGGER.debug(f"HTTP status: {resp.status_code}")
except Exception as e:
LOGGER.error("Request failed", exc_info=True)
⚠️ 注意事项：
- builtins 方案适用于中小型项目或快速原型；在大型协作项目中，应优先考虑更显式、可测试的设计（如依赖注入、logging.config.dictConfig 或封装为模块级单例）；
- 避免滥用 builtins——仅用于真正需要全局共享的、无状态或轻状态对象（如 LOGGER），切勿用于可变状态容器（如 list 或 dict），否则易引发隐式耦合与并发风险；
- 确保 logger_setup.py 在应用启动早期被导入（例如在 __main__.py 或入口脚本首行），否则其他模块可能因 LOGGER 尚未定义而抛出 NameError；
- 若使用 multiprocessing，注意子进程不会自动继承父进程的 builtins 修改，需在每个子进程中重新设置或改用 logging 的进程安全配置。
综上，builtins.LOGGER 提供了一种“约定优于配置”的便捷路径，但其本质是全局副作用——务必搭配清晰的文档说明，并在团队规范中明确使用边界。
