Python使用PyQt5时如何理解并避免循环导入问题

Python导入模块时，会先将未完全初始化的模块对象存入sys.modules，再逐行执行模块代码，避免重复导入。

• 仅1个子模块导入main时，执行顺序为：运行main.py → 加载子模块 → 子模块导入半初始化的main对象 → 子模块完成类定义 → 回到main.py完成Main类定义。只要子模块没有在顶层代码直接访问main.Main（比如仅在类型标注中引用），就不会触发属性不存在的错误。
• 2个及以上子模块导入main时，第一个子模块加载完成后，main还未执行到Main类的定义，就会开始加载第二个子模块。如果第二个子模块需要访问main.Main（比如类型标注开启了实时解析），半初始化的main模块中还不存在Main类，就会抛出AttributeError。

按改造成本从低到高排序，适配你当前的PyQt窗口拆分场景：

• 方案1：开启延迟类型标注
  Python 3.7及以上版本支持，在所有子模块的第一行添加from __future__ import annotations，所有类型标注会以字符串形式存储，运行时不会立刻解析，无需修改任何业务代码即可解决循环导入问题。
  子模块示例：

  from __future__ import annotations
  import main
  
  class Foo():
      def __init__(self, main_pointer: main.Main):
          self.main_pointer: main.Main = main_pointer
  
      def do_something(self):
          print(self.main_pointer.lots_of_important_attributes)
  

• 方案2：函数内导入子模块
  将main模块中对子模块的导入从顶层移到使用子模块的函数内部，这样main模块完成Main类定义后才会触发子模块的导入，彻底避免半初始化问题：
  main.py示例：

  class Main():
      def __init__(self):
          self.lots_of_important_attributes: SomeObject
  
      def do_something_else(self):
          # 函数内部导入，仅在调用时执行
          import sub_module
          import sub_module2
          foo = sub_module.Foo(self)
          foo.do_something()
          bar = sub_module2.Bar(self)
          bar.do_something()
  

• 方案3：抽象协议层（架构最规范）
  新增独立的base.py模块，定义主窗口的协议接口，子模块仅依赖base模块，完全打破子模块对main模块的依赖，适合长期维护的大项目：
  base.py示例：

  from typing import Protocol
  from PyQt5.QtWidgets import QMainWindow
  
  class IMainWindow(Protocol):
      lots_of_important_attributes: SomeObject
  

  子模块示例：

  from base import IMainWindow
  
  class Foo():
      def __init__(self, main_pointer: IMainWindow):
          self.main_pointer: IMainWindow = main_pointer
  
      def do_something(self):
          print(self.main_pointer.lots_of_important_attributes)
  

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