Python 类型提示中的“at”符号 (@)（由 Pylance / Pyright 建议）

Question

2022 年 7 月发布的Visual Studio Code Python 扩展引入了“ Inlay Type Hints ”，它会自动建议没有显式注释的函数的返回类型。要启用它，您可以设置"python.analysis.inlayHints.functionReturnTypes": trueIDE 用户设置（首选项：打开设置 (JSON) 命令）。

在测试此功能时，我注意到类中存在以下建议：

...其中黄色突出显示的文本是 Python 扩展建议的返回类型，该扩展基于Pylance，而 Pylance 本身又依赖于Pyright。

我的问题是：@这个建议中的标志是什么意思？是否有 PEP 引用这种类型注释（使用Self@...），或者这种类型提示特定于Pyright，与标准约定不同？我在哪里可以找到更多相关信息？

我在这里发现了一个类似的 Stackoverflow 问题，但没有得到任何答案。

Answer 1

这@表明Self是一个TypeVar, 并在类的上下文中指Self@HereIsMyClassName代(它也可以是一个函数)。这不是有效的 Python。（从技术上讲，它是有效的，因为运算符是矩阵乘法，因此您是矩阵乘法和。但是，这不是本意，而且实际上没有任何意义。）不要在代码中编写此内容，但要知道这就是 Pylance在显示类型定义时向您显示的方式。（可能还有其他编辑器和扩展。）SelfHereIsMyClassName@SelfHereIsMyClassNameTypeVar