Python泛型类型场景下如何避免循环导入？

你遇到的是Python中泛型类型提示在循环导入场景下的运行时错误——因为TYPE_CHECKING块里的导入仅在类型检查阶段生效，而泛型（比如list[A]）需要在运行时解析类型参数，导致运行时找不到A或B的定义。下面是几个实用的解决办法：

• 方法一：使用字符串字面量类型提示
  直接把泛型里的类型参数改成字符串形式，Python运行时不会立即解析这个类型，仅在类型检查时才会识别对应的类：
  mwe1.py 修改后：

  from typing import TYPE_CHECKING
  if TYPE_CHECKING:
      from .mwe2 import A
  
  class B:
      def get_as(self) -> list["A"]:  # 将A改为字符串"A"
          return []
  

  mwe2.py 同理修改：

  from typing import TYPE_CHECKING
  if TYPE_CHECKING:
      from .mwe1 import B
  
  class A:
      def get_bs(self) -> list["B"]:  # 将B改为字符串"B"
          return []
  

• 方法二：启用from __future__ import annotations
  这是Python 3.7及以上版本支持的特性，开启后所有类型提示都会被自动当作字符串处理，延迟到需要时才解析，无需手动加引号：
  mwe1.py 修改后：

  from __future__ import annotations
  from typing import TYPE_CHECKING
  if TYPE_CHECKING:
      from .mwe2 import A
  
  class B:
      def get_as(self) -> list[A]:  # 保持原有写法即可
          return []
  

  mwe2.py 同理添加开头语句：

  from __future__ import annotations
  from typing import TYPE_CHECKING
  if TYPE_CHECKING:
      from .mwe1 import B
  
  class A:
      def get_bs(self) -> list[B]:  # 无需修改类型提示
          return []
  

  注意：Python 3.10+中标准库泛型（如list）支持直接用list[A]写法，无需导入typing.List，该特性与annotations完全兼容。

• 方法三：拆分公共类型到独立模块
  如果A和B的相互引用源于类型依赖，可将它们的公共抽象或类型定义移到单独模块（如common_types.py），两个模块再从公共模块导入所需内容：
  新建common_types.py：

  from __future__ import annotations
  class A:
      pass
  class B:
      pass
  

  mwe1.py 修改后：

  from typing import TYPE_CHECKING
  if TYPE_CHECKING:
      from .common_types import A
  from .common_types import B  # 运行时直接导入基类B
  
  class B(B):  # 继承公共模块的B
      def get_as(self) -> list[A]:
          return []
  

  mwe2.py 同理修改：

  from typing import TYPE_CHECKING
  if TYPE_CHECKING:
      from .common_types import B
  from .common_types import A  # 运行时直接导入基类A
  
  class A(A):  # 继承公共模块的A
      def get_bs(self) -> list[B]:
          return []
  

  该方法适合类结构复杂、需要明确抽象层的场景。

• 方法四：函数内局部导入（仅特殊场景适用）
  若循环导入仅出现在方法的类型提示中，可在方法内部做运行时导入，但此方法会降低代码可读性，不推荐常规使用：
  mwe1.py 修改示例：

  class B:
      def get_as(self) -> list["A"]:
          from .mwe2 import A  # 方法内局部导入
          return []
  

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