模块化拆分类方法时添加类型提示出现循环导入如何解决

下面是几种生产环境常用的可行方案，兼顾IDE代码补全能力和运行时的导入正确性：

方案1：使用typing.TYPE_CHECKING隔离类型导入（最常用） #

TYPE_CHECKING是typing模块提供的专属常量，仅在静态类型检查阶段（IDE补全、mypy校验等）为True，运行时默认是False，将类的导入放在该判断块内即可避免运行时循环导入，同时不影响IDE的类型识别。
my_method.py示例代码：

from typing import TYPE_CHECKING
# 仅类型检查阶段执行导入
if TYPE_CHECKING:
    from my_number import MyNumber

# Python 3.7+ 可添加 `from __future__ import annotations` 后省略类型的引号
def my_method(self: "MyNumber"):
    print(self.x)

方案2：直接使用字符串形式的前向类型引用 #

Python的所有主流静态类型检查工具（PyCharm、Pylance、mypy）都支持直接用字符串作为类型提示，不需要提前导入对应的类，运行时也不会解析字符串内容，自然不会触发循环导入，写法最简单。
my_method.py示例代码：

def my_method(self: "MyNumber"):
    print(self.x)

方案3：使用Mixin类拆分逻辑（官方推荐最佳实践） #

相比直接在类内部导入单个方法，将同类方法封装为Mixin类再让主类继承，是Python官方更推荐的代码拆分方式，维护性更强，同样可以配合上述类型提示方案解决循环导入问题。
示例代码：
my_mixin.py：

from typing import TYPE_CHECKING
if TYPE_CHECKING:
    from my_number import MyNumber

class MyNumberMixin:
    def my_method(self: "MyNumber"):
        print(self.x)
    
    # 同模块的其他方法可以统一放在这里
    def another_method(self: "MyNumber"):
        print(self.x * 2)

my_number.py：

from my_mixin import MyNumberMixin

class MyNumber(MyNumberMixin):
    def __init__(self):
        self.x = 5

方案4：使用存根文件（.pyi）单独存放类型定义 #

将类型提示单独存放在和业务文件同名的.pyi存根文件中，运行时Python不会读取存根文件内容，不会触发循环导入，适合不想修改业务代码的场景。
示例代码：
my_method.pyi（存根文件，仅用于类型检查）：

from my_number import MyNumber

def my_method(self: MyNumber) -> None: ...

my_method.py（业务代码无需修改）：

def my_method(self):
    print(self.x)

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