全局依赖致单元测试无法实现?Python跨模块共享实例的Pythonic方法
模块间共享配置、实例的Pythonic实现方案
针对你遇到的手动透传引用导致耦合过高、没法开展单元测试的问题,没有必要套用复杂的企业级架构方案,下面几种都是适配你当前项目规模、经过社区长期验证的标准做法:
最省心的方案:用Python模块做天然全局单例
你现在已经在按模块拆分代码了,完全不需要自己写一堆Give*函数手动传递引用——Python的模块本身就是天生的全局单例容器,所有导入同一个模块的代码,拿到的都是同一个模块实例。
具体改造步骤:
- 新建一个独立的上下文模块,比如命名为
runtime_context.py,把所有需要全局共享的内容(冒险配置、角色配置、日志器)都定义成这个模块的模块级变量,初始值设为None就行 - 只在程序最启动的入口处,给这些变量赋值一次,不需要挨个给下游模块发通知
写个实际的改造例子:
# runtime_context.py 内容,没有任何复杂逻辑 # 全局共享的配置引用,后续所有模块直接访问就行 adv_config = None char_config = None app_logger = None
# 程序启动入口的初始化逻辑,只跑一次 def init_app(config_dir: str): # 导入模块后直接给模块变量赋值 from project import runtime_context from configobj import ConfigObj import logging # 加载游戏配置 runtime_context.adv_config = ConfigObj(f"{config_dir}/adv.conf") runtime_context.char_config = ConfigObj(f"{config_dir}/char.conf") # 初始化日志器 runtime_context.app_logger = logging.getLogger("scenzig_engine") runtime_context.app_logger.setLevel(logging.INFO)
- 其他所有需要用到配置的模块,根本不需要接收任何传参,直接导入这个上下文模块读取变量就行:
# 原来的efunc.py中的业务逻辑 from project import runtime_context def get_action_detail(action_id: str): # 直接从上下文模块拿配置引用,不需要全局声明,不需要接收透传参数 return runtime_context.adv_config["Actions"][str(action_id)]
这种方式的优势:
- 彻底砍掉你原来写的所有
GiveAdv/GiveChar透传逻辑,不管调用链有多长,需要配置的模块直接从上下文模块取,不会出现漏写透传逻辑导致的连锁报错 - 单元测试非常好写:测试的时候你只需要给
runtime_context的对应变量赋一个测试用的mock字典,就能直接跑业务逻辑,不需要走完整的应用启动流程
适配测试场景的轻量改造
如果你希望业务函数尽量减少对全局模块的硬依赖,又不想牺牲正常运行时的便利性,可以用非常简单的可选参数实现轻量依赖注入:
给需要用到配置的函数加一个可选入参,默认值从全局上下文拿,测试的时候可以传入自定义的测试值覆盖默认引用。
举个改造例子:
# 改造后的efunc.py from project import runtime_context def get_action_detail( action_id: str, adv_config=runtime_context.adv_config # 可选参数,默认用全局共享的配置 ): return adv_config["Actions"][str(action_id)]
这种写法的好处:
- 正常业务运行时,你调用函数根本不需要额外传参,和之前的使用体验没有任何区别
- 单元测试时,你可以直接给
adv_config参数传入一个构造好的测试字典,完全不碰全局状态,满足单元测试的隔离要求
日志器的适配技巧
Python内置的logging模块本身就是按全局命名空间设计的,根本不需要手动传递日志器引用:
- 你只需要在应用启动时调用一次
logging.basicConfig(),配置好日志的输出格式、级别、存储路径 - 后续任意模块里,只要调用
logging.getLogger("scenzig_engine"),拿到的都是同一个全局日志实例,和你在哪个模块、有没有传过引用没有关系
你之前担心的“到处传日志器”的问题,本质上是没有利用好logging模块自带的全局查找能力,完全是可以避免的重复工作。
为什么你当前的透传方式会遇到阻碍
你现在写的Give*函数,本质上是手动把全局引用一层一层往下传,相当于手动复刻了Python模块的全局实例能力,但没有任何容错:
- 每新增一个需要用配置的模块,你就要在所有
Give*函数里加一行调用,漏写就会触发变量未定义的错误 - 合并模块、重构逻辑的时候,很容易因为透传链路改乱出现连锁问题
- 测试的时候必须把整条透传链路跑通才能拿到配置,根本没法单独测试某一个函数
内容的提问来源于stack exchange,提问作者zig13
相关产品推荐
相关产品推荐

