在 python 类中为接收本类实例的方法添加类型提示时，需启用延迟求值注解（pep 563），否则会因类名在定义时尚未存在而引发 nameerror。
在 python 类中为接收本类实例的方法添加类型提示时，需启用延迟求值注解（pep 563），否则会因类名在定义时尚未存在而引发 nameerror。
在定义类的实例方法时，若希望将“当前类的另一个实例”作为参数类型进行标注（例如 def compare(self, other: MyClass)），直接书写会导致 NameError: name 'MyClass' is not defined ——这是因为类体在执行时，类名 MyClass 尚未被绑定到命名空间中，类型提示在运行时被求值（Python < 3.7 默认行为），从而无法解析前向引用。
✅ 正确做法是启用延迟注解求值（Postponed Evaluation of Annotations），即让类型提示字符串保持原样，不立即执行，直到实际需要（如通过 get_type_hints() 或类型检查器访问时）才解析。自 Python 3.7 起，可通过导入 from __future__ import annotations 全局启用该特性：
from __future__ import annotations
class MyClass:
def compare(self, other: MyClass) -> bool:
return self.__dict__ == other.__dict__此写法完全合法，且被 mypy、pyright、PyCharm 等主流类型检查工具和 IDE 正确识别。注意：该导入必须位于模块顶部（在任何其他语句之前），且仅影响当前模块。
⚠️ 补充说明：
立即学习“Python免费学习笔记（深入）”；
- 若使用 Python < 3.7，可改用字符串字面量（other: 'MyClass'）实现前向引用，但可读性与维护性较差；
- 在 __init__ 或类方法中返回 self 类型时，推荐使用 -> Self（Python 3.11+，需 from typing import Self），比字符串 'MyClass' 更安全、更语义化；
- 启用 annotations 后，所有注解均变为字符串，因此 print(MyClass.compare.__annotations__) 将输出 {'other': 'MyClass', 'return': 'bool'}，而非原始类型对象。
总之，from __future__ import annotations 是现代 Python 类型提示实践的标准配置，既解决前向引用问题，又提升代码简洁性与类型系统一致性。
