将类用作其方法中参数的类型提示[duplicate]

Question

下面包含的代码抛出以下错误：

NameError: name 'Vector2' is not defined 

在这一行：

def Translate (self, pos: Vector2):

为什么Python不能在Translate方法中识别我的Vector2类？

class Vector2:

    def __init__(self, x: float, y: float):

        self.x = x
        self.y = y

    def Translate(self, pos: Vector2):

        self.x += pos.x
        self.y += pos.y

Answer 1

也许另一种选择是以前定义类，用一个空的实现。我想最常见的解决方案是前向引用，但我的建议是更安全的类型，毕竟这是添加类型的目的。

class Vector2:
    pass

class Vector2:

    def __init__(self, x: float, y: float):
        self.x = x
        self.y = y

    def Translate(self, pos: Vector2):
        self.x += pos.x
        self.y += pos.y

Answer 2

您要求的特性称为前向（类型）引用，并且从3.7开始（在PEP 563中）它就被添加到Python中¹因此这现在是有效的：

from __future__ import annotations
class C:
    def spam(self, other: C) -> C:
        pass

请注意\uuuuuuuuuuuuuuu语句。这在4.0之前是必需的。

不幸的是，在Python3.6和更早版本中，此功能不可用，因此必须使用字符串注释，正如Jim Fasarakis Hilliard的回答中所解释的那样。

Mypy已经支持转发声明，即使在Python3.6下运行，但是如果静态类型检查器说您的代码很好，但是当您尝试实际运行它时，解释器会引发一个NameError，这对您没有多大好处。

_{1。这在PEP 484中已经作为一个可能的特性进行了讨论，但推迟到后来，在人们有了更多在注释中使用前向声明的经验之后。PEP 563/Python 3.7就是“以后”}

Answer 3

因为当它遇到Translate（在编译类主体时），Vector2尚未定义（它当前正在编译，尚未执行名称绑定）；Python自然会抱怨。

由于这是这样一个常见的场景（在类的主体中键入提示类），您应该通过用引号括起来来使用对它的前向引用：

class Vector2:    
    # __init__ as defined

    def Translate(self, pos: 'Vector2'):    
        self.x += pos.x
        self.y += pos.y

Python（和任何符合PEP 484的检查器）将理解您的提示并适当地注册它。当通过__annotations__访问typing.get_type_hints时，Python确实认识到这一点：

from typing import get_type_hints

get_type_hints(Vector2(1,2).Translate)
{'pos': __main__.Vector2}

从Python 3.7开始，这已经改变了；见下面abarnert的回答。