本文介绍如何用依赖注入替代全局回调变量，实现 ui_theme 与 cards_page 模块间的松耦合通信，通过构造时传入监听器实例，提升可测试性与可维护性。
本文介绍如何用依赖注入替代全局回调变量，实现 ui_theme 与 cards_page 模块间的松耦合通信，通过构造时传入监听器实例，提升可测试性与可维护性。
在 Python GUI 或响应式 UI 开发中，模块间因事件触发而产生跨文件调用（如主题变体选择后通知卡片页更新）是常见需求。但直接使用全局可变回调函数（如 ui_theme.on_change_variant_callback = ...）会带来严重隐患：全局状态难以追踪、单元测试无法隔离、多实例场景下易发生回调覆盖或内存泄漏。
依赖注入在此场景下正是更优解——它不意味着必须引入复杂框架，而是遵循“将依赖关系显式传递而非隐式查找”的原则。核心思想是：ui_theme 不应自行决定谁来响应事件，而应提供可被注入的回调执行点；cards_page 作为业务逻辑持有者，主动提供并绑定其处理函数。
以下为推荐实现：
# ui_theme.py
class ThemeVariantListener:
"""主题变体变更事件监听器 —— 可被注入的依赖项"""
def __init__(self):
self._on_change_callback = None
def set_on_change_callback(self, callback):
"""显式设置回调，支持运行时重置（如切换页面时）"""
if not callable(callback):
raise TypeError("Callback must be callable")
self._on_change_callback = callback
def on_change_variant_click(self, dbref, msg, to_ms):
"""事件触发入口：仅负责分发，不持有业务逻辑"""
print("button clicked:", msg.value)
if self._on_change_callback:
self._on_change_callback(dbref, msg, to_ms)# cards_page.py
import ui_theme
class CardsPage:
def __init__(self, theme_listener: ui_theme.ThemeVariantListener):
# ✅ 依赖通过构造函数注入 —— 清晰、可控、可 mock
self.theme_listener = theme_listener
def on_variant_select(self, dbref, msg, to_ms):
# 此处封装具体业务逻辑（如刷新卡片数据、更新布局等）
print(f"CardsPage received variant change: {msg.value}")
def setup_event_binding(self):
"""绑定时机由使用者控制，避免初始化顺序陷阱"""
self.theme_listener.set_on_change_callback(self.on_variant_select)# main.py —— 依赖组装中心（Composition Root）
from cards_page import CardsPage
import ui_theme
def main():
# 1️⃣ 创建共享的监听器实例（单例或按需新建）
theme_listener = ui_theme.ThemeVariantListener()
# 2️⃣ 将监听器注入 CardsPage 实例
cards_page = CardsPage(theme_listener)
# 3️⃣ 主动触发绑定（明确生命周期）
cards_page.setup_event_binding()
# 4️⃣ 后续可将 theme_listener 传递给其他模块（如 navigation.py）
# 或直接在 UI 构建阶段关联：variant_selector.on_change = theme_listener.on_change_variant_click
if __name__ == "__main__":
main()✅ 关键优势总结：
立即学习“Python免费学习笔记（深入）”；
- 解耦彻底：ui_theme 不再 import cards_page，也不依赖任何全局变量；
- 可测试性强：单元测试 CardsPage 时可传入 Mock(ThemeVariantListener)，验证回调是否被正确注册；
- 生命周期可控：set_on_change_callback 支持多次调用，便于页面复用或动态切换处理器；
- 类型安全友好：配合类型提示（如 theme_listener: ui_theme.ThemeVariantListener），IDE 和静态检查工具能有效辅助开发。
⚠️ 注意事项：
- 避免在 ThemeVariantListener.__init__() 中自动绑定回调，这会破坏注入的灵活性；
- 若存在多个订阅者（如同时通知卡片页和日志模块），可将 set_on_change_callback 升级为 add_on_change_listener + remove_listener，内部维护回调列表；
- 在异步或线程敏感环境（如某些 GUI 框架），需确保回调执行在线程安全上下文中，必要时添加 @mainthread 或 asyncio.ensure_future 包装。
这种轻量级依赖注入模式无需第三方库，却能显著改善代码结构——它不是银弹，但确实是告别“全局回调地狱”的务实之选。
