Self能解决链式调用类型提示问题，因其表示“当前具体类”，在继承中自动协变收敛，避免硬编码类名导致的子类类型丢失；必须统一用于所有链式方法返回类型，且仅适用于实例/类方法，不可用于staticmethod或属性标注。

怎样在python 3.11中使用self类型优雅标注链式调用方法返回类型？

为什么 `Self` 在 Python 3.11 中能解决链式调用的类型提示问题？

因为旧写法（如 -> MyClass）在继承场景下会丢失子类类型信息，导致 mypy 报错或类型推导失败；而 Self 是一个特殊类型变量，表示「当前具体类」，不是泛型占位符也不是硬编码类名，它随调用方的实参类型自动收敛。

典型错误现象：mypy 提示 Returning Any from function declared to return "MyClass" 或链式调用第二步方法不可见——这往往是因为返回类型没正确绑定到子类。

Self 必须从 typing 导入（Python 3.11+ 原生支持，无需 from typing_extensions import Self）
不能用于类外部的函数，只能在实例方法、类方法中作为返回类型（__new__ 和 __init__ 除外）
不支持在 staticmethod 中使用——它没有「当前类」语义

怎么给实例方法标注 `Self` 并确保链式调用被正确识别？

关键在于：所有参与链式调用的方法都必须统一返回 Self，且不能混用 -> "MyClass" 或 -> MyClass。

from typing import Self
<p>class Builder:
def <strong>init</strong>(self) -> None:
self._value = 0</p><pre class="brush:php;toolbar:false;">def set_value(self, v: int) -> Self:
    self._value = v
    return self

def double(self) -> Self:
    self._value *= 2
    return self

正确：mypy 能推导出 b 的类型是 Builder，且支持连续调用

b = Builder().set_value(5).double()

如果某个方法漏标 -> Self（比如写了 -> None），链式就会在那一步中断
返回 self 是强制要求——Self 类型只对实际返回 self 的方法有意义
若方法内部可能返回 None 或其他对象，就不能用 Self，得改用泛型或联合类型

继承时 `Self` 为什么不会退化成父类类型？

因为 Self 是协变的（covariant），当子类调用父类方法时，Self 自动解析为子类本身，而不是声明该方法的父类。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

class AdvancedBuilder(Builder):
    def triple(self) -> Self:
        self._value *= 3
        return self
<h1>下面这行完全合法，mypy 知道 advanced 是 AdvancedBuilder 类型</h1><p>advanced = AdvancedBuilder().set_value(2).triple().double()
</p>

如果父类方法返回的是硬编码的 -> Builder，那么 AdvancedBuilder().set_value(2) 的类型就是 Builder，后续调用 triple() 就会报错
Self 不需要任何装饰器、泛型参数或重载，纯静态类型系统层面的推导
注意：类属性或实例属性不能标注为 Self——它只适用于函数返回类型

哪些情况会让 `Self` 失效或触发 mypy 误报？

最常见的是和泛型类、__new__、类型擦除操作混用，导致类型上下文丢失。

在泛型类中直接用 Self 是安全的，但若方法签名里还带额外泛型参数（如 def add[T](self, x: T) -> Self），某些 mypy 版本（Self
__new__ 方法不能返回 Self（即使语法允许），因为它在实例创建前执行，mypy 会警告 Invalid self argument
用 cast(Self, ...) 强转时要格外小心——一旦目标对象不是当前类实例，运行时没问题，但类型系统会误以为安全
如果你看到 error: Invalid type "Self"，大概率是用了太老的 mypy（需 ≥ 1.0）或没开 python_version = "3.11" 配置