Python返回类型提示作用域疑问：交叉引用类标注为何报错？

咱们直接拆解问题核心：Python处理普通函数代码和类型注解的时机完全不同，这就是两个方法一个正常、一个报错的关键！

为什么return_B_with_out_annotation能正常工作？ #

当你写return B()的时候，这行代码属于运行时执行的逻辑——只有当你实际调用这个方法的时候，Python才会去执行B()创建实例。而调用方法的时机肯定是在你定义完类A和类B之后，这时候类B已经被Python完全加载，自然能找到B的定义，所以不会出问题。

为什么return_B_with_annotation会抛出NameError？ #

这里有两个需要注意的点：

1. 注解解析时机问题：Python在定义类A的过程中，会立即计算类型注解里的表达式。你写的-> B()，Python会试图在这个阶段就执行B()来确定注解内容，但此时类B还没被定义（它在A的后面），所以直接抛出NameError，提示找不到B这个名字。
2. 类型注解写法错误：顺便纠正个小问题——正确的类型注解应该是-> B，表示返回值是类B的实例；而你写的-> B()是试图创建一个B的实例当作注解，这不是类型标注的正确用法哦。

解决办法 #

针对这种“超前引用”的类型注解场景，有几种通用方案：

方案1：使用字符串形式的类型注解 #

把注解写成字符串"B"，Python解析时不会立即计算这个字符串，而是在需要的时候才去解析，这时候类B已经定义完成了：

class A:
    def return_B_with_out_annotation(self):
        return B()
    def return_B_with_annotation(self) -> "B":
        return B()
class B:
    pass

方案2：启用__future__的annotations特性（Python 3.7+） #

在文件开头导入from __future__ import annotations，这样所有类型注解都会被自动当作字符串处理，不需要手动加引号：

from __future__ import annotations

class A:
    def return_B_with_out_annotation(self):
        return B()
    def return_B_with_annotation(self) -> B:
        return B()
class B:
    pass

方案3：调整类的定义顺序（仅适用于单向依赖场景） #

如果类B不依赖类A，你可以先定义B再定义A，但如果B里也有返回A的方法，这个方案就不适用了，此时前两个方案更通用。

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