如何为自定义类实例添加类型提示？解决NameError报错

这个错误的核心原因很直接：当你在Cust类内部的方法里用Cust作为类型提示时，Python执行到这段方法代码的时候，Cust类还没完成完整定义，所以会提示名称未定义。

下面是几种实用的解决方法：

方法1：用字符串包裹类名（全Python版本兼容） #

直接把类名放在单引号或双引号里，Python的类型检查工具（比如mypy）能正常识别这个字符串对应的类：

class Cust:
    def __init__(self):
        ...
    
    def method(self, other: 'Cust'):
        ...

方法2：导入__future__.annotations（Python 3.7+推荐用） #

从__future__里导入annotations后，所有类型提示都会被当成字符串处理，直到运行时才解析，完美绕开类定义顺序的问题：

from __future__ import annotations

class Cust:
    def __init__(self):
        ...
    
    def method(self, other: Cust):
        ...

方法3：用typing.ForwardRef显式处理（Python 3.6+） #

如果需要更显式的前向引用处理，可以用ForwardRef包装类名，不过要配合typing.get_type_hints在运行时解析类型：

from typing import ForwardRef

CustRef = ForwardRef('Cust')

class Cust:
    def __init__(self):
        ...
    
    def method(self, other: CustRef):
        ...

另外提一句：你之前试的type(Cust)和Type[Cust]是用来标注类本身的（比如参数需要传入Cust这个类，而不是它的实例），和你要标注实例的需求不匹配，所以就算解决了NameError，也不符合你的实际场景。

内容的提问来源于stack exchange，提问作者TheRavenSpectre