typing.Self 在 Python 3.11 才正式引入，3.10 及更早需用 typing_extensions>=4.2.0 的 Self 替代，并确保 mypy>=0.980，统一导入、显式标注、禁用字符串前向引用以保障链式调用类型推导正确。

typing.self 如何在 python 3.11 前用 typing_extensions 回退

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"）——那会丢失协变性，破坏链式调用推导。

ApiPost接口调试与文档生成工具

ApiPost是一个支持团队协作，支持模拟POST、GET、PUT等常见请求，并可直接生成文档的API调试、管理工具，ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具，ApiPost官方版界面美观大方，功能强劲实用，支持团队协作，支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键

下载

from typing_extensions import Self
<p>class Box:
def <strong>init</strong>(self, value: int) -> None:
self.value = value</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

类型检查器能正确识别 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。若遇到这类错误：

先关掉插件验证是否消失：mypy --no-plugins your_file.py
确保 mypy ≥0.980 且 typing_extensions ≥4.2.0
避免在泛型类中对 Self 做子类约束（如 def method(self) -> Self[T]），这在 typing_extensions 中尚未完全支持，容易触发内部错误

Self 的核心价值是让类型系统理解“返回的是调用者的精确类型”，而不是粗粒度的类名字符串；回退方案本身很干净，但版本锁和工具链对齐是实际落地时最容易卡住的地方。