Self能解决链式调用类型提示问题，因其表示“当前具体类”，在继承中自动协变收敛，避免硬编码类名导致的子类类型丢失；必须统一用于所有链式方法返回类型，且仅适用于实例/类方法，不可用于staticmethod或属性标注。
为什么 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+ 需要开启：辅助功能 + 屏幕录制权限
立即学习“Python免费学习笔记（深入）”；
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()
- 如果父类方法返回的是硬编码的
-> 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"配置
真正容易被忽略的是：Self 只解决「返回当前实例」的链式场景；如果有条件分支返回不同实例（比如 builder 模式中根据 flag 返回不同子类），就得退回到 TypeVar("T", bound="Base") + 泛型方法，Self 不适用。
