typing.Self 在 Python 3.11 才正式引入，3.10 及更早需用 typing_extensions>=4.2.0 的 Self 替代，并确保 mypy>=0.980，统一导入、显式标注、禁用字符串前向引用以保障链式调用类型推导正确。
typing.Self 在 Python 3.11 前不可用，必须回退
Python 3.11 才正式引入 typing.Self，3.10 及更早版本中直接使用会触发 NameError: name 'Self' is not defined 或类型检查器（如 mypy）报错 error: Name "Self" is not defined。不能靠条件导入 typing.Self 来“兼容”，因为 AST 解析阶段就失败了。
用 typing_extensions.Self 替代，但需满足版本要求
typing_extensions 从 v4.2.0 开始支持 Self（对应 PEP 673），且仅在 Python 3.7+ 上可用。低于 v4.2.0 的版本（如常见于旧项目中的 v3.7.4）不包含该符号，强行导入会报 ImportError: cannot import name 'Self' from 'typing_extensions'。
- 确认已安装 ≥v4.2.0：
pip install "typing_extensions>=4.2.0" - 统一用
from typing_extensions import Self，**不要**写成from typing import Self（3.10- 会炸） - mypy 需 ≥v0.980（否则不认识
Self语义），pyright/pylance 通常较新，基本无碍
类内方法返回 Self 的写法要一致
回退后写法和 3.11+ 完全一致，类型检查器能正确推导链式调用。关键点是：所有涉及返回当前实例的方法，都必须显式标注返回类型为 Self，且不能混用字符串前向引用（如 "MyClass"）——那会丢失协变性，破坏链式调用推导。
from typing_extensions import Selfclass Box: def init(self, value: int) -> None: self.value = value
def set_value(self, v: int) -> Self: self.value = v return self def double(self) -> Self: self.value *= 2 return self类型检查器能正确识别 b.double().set_value(42) 是 Box 实例
b = Box(10).double().set_value(42)
注意 mypy 的 --enable-error-code 和插件干扰
某些旧版 mypy 插件（如
mypy-zope或自定义插件）可能未适配Self，导致误报error: Invalid self type。若遇到这类错误：立即学习“Python免费学习笔记（深入）”；
- 先关掉插件验证是否消失：
mypy --no-plugins your_file.py - 确保 mypy ≥0.980 且
typing_extensions≥4.2.0 - 避免在泛型类中对
Self做子类约束（如def method(self) -> Self[T]），这在 typing_extensions 中尚未完全支持，容易触发内部错误
Self 的核心价值是让类型系统理解“返回的是调用者的精确类型”，而不是粗粒度的类名字符串；回退方案本身很干净，但版本锁和工具链对齐是实际落地时最容易卡住的地方。
