如何为classmethod的Self返回类型正确添加类型提示？

首先纠正你的误解：用typing.Self（Python 3.11+可直接使用Self）作为类方法的返回类型是完全正确的，不会导致子类返回类型错误。

完整实现示例 #

from typing import Self  # Python 3.8-3.10需导入，3.11+无需导入

# 先定义Bar类的类型
class Bar:
    def is_foobar(self) -> bool:
        ...

class Foo:
    def __init__(self, value: str = ""):
        ...  # 你的初始化逻辑

    @classmethod
    def from_bar(cls, bar: Bar) -> Self:
        if bar.is_foobar():
            return cls('foobar')
        else:
            return cls()

# 子类测试
class Foobar(Foo):
    pass

# 类型检查器会正确识别返回值为Foobar实例
fb: Foobar = Foobar.from_bar(Bar())

为什么方案一的担忧不成立 #

Self类型在类方法中会动态绑定到调用该方法的类。当子类Foobar调用from_bar时，cls指向Foobar，返回的cls(...)是Foobar实例，此时Self会被类型检查器（如mypy、pyright）自动推断为Foobar，完全匹配实际返回类型，不会出现类型错误。

方案二的问题所在 #

静态方法不适合这种场景：一方面静态方法无法获取当前类的cls参数，硬编码返回Foo会导致子类调用from_bar时，实际返回子类实例但类型标注是父类，造成类型提示不符；另一方面类定义内部直接引用Foo会存在提前引用的问题，所以方案二本身就不合理。

总结 #

你并没有把问题复杂化，只是对Self类型的作用理解有偏差。@classmethod搭配Self类型提示，就是这类替代构造函数的标准写法，主流类型检查工具都能正确处理子类的返回类型推断。

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