Python排序基类方法如何正确声明自身类类型的参数类型提示

你遇到的是类型前向引用问题：在类定义内部直接将类本身作为类型提示时，Python解释器还未完成SortingAlgorithm类的整体定义，因此无法识别该类型，直接写就会报未解析引用错误。你尝试导入当前文件类名触发的循环导入，本质也是同样的逻辑：尝试引用还未完成定义的对象。

下面是几种可行的解决方案：

方案1：开启延迟类型注解（兼容Python 3.7+，最通用） #

只需在代码文件顶部引入from __future__ import annotations，Python会延迟所有类型注解的解析时机，等整个模块加载完成后再处理，无需修改原有类型提示的写法，也不会触发循环导入问题。
示例代码：

from __future__ import annotations
import abc
from typing import Sequence

class SortingAlgorithm(abc.ABC):
    @staticmethod
    def presort(input_list: list, algorithms: Sequence[SortingAlgorithm]) -> list:
        # 可选：运行时类型校验，拦截非法参数
        for algo in algorithms:
            if not isinstance(algo, SortingAlgorithm):
                raise TypeError(f"参数{algo}不属于SortingAlgorithm子类实例")
        # 预排序业务逻辑
        mid = len(input_list) // 2
        input_list[:mid] = algorithms[0].sort(input_list[:mid])
        input_list[mid:] = algorithms[1].sort(input_list[mid:])
        return input_list

    @abc.abstractmethod
    def sort(self, input_list: list) -> list:
        pass

方案2：字符串形式类型提示（兼容所有Python版本） #

如果不方便加future导入，可以直接把类名用引号包裹，所有主流类型检查工具（mypy、pyright、IDE自带检查工具）都可以正常识别这种写法的类型提示：

import abc
from typing import Sequence

class SortingAlgorithm(abc.ABC):
    @staticmethod
    def presort(input_list: list, algorithms: Sequence["SortingAlgorithm"]) -> list:
        # 业务逻辑和运行时校验同上
        pass

    @abc.abstractmethod
    def sort(self, input_list: list) -> list:
        pass

方案3：使用Self类型（Python 3.11+） #

如果你的运行环境是Python 3.11及以上，可以直接用标准库的typing.Self指代当前类，写法更简洁直观：

import abc
from typing import Sequence, Self

class SortingAlgorithm(abc.ABC):
    @staticmethod
    def presort(input_list: list, algorithms: Sequence[Self]) -> list:
        # 业务逻辑同上
        pass

    @abc.abstractmethod
    def sort(self, input_list: list) -> list:
        pass

补充说明：

• 上述方案首先解决的是静态类型检查的需求，开发阶段可以通过mypy、pyright等工具自动校验参数类型是否合法。
• 如果需要运行时强制拦截非法参数，保留示例中的isinstance校验逻辑即可。

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