如何正确为Python函数中的对象类型变量添加类型注解

你遇到的报错本质是前向引用问题：执行到类A的方法注解时，类B还没有完成定义，解释器找不到名称B触发错误。可以通过以下两种常用方案解决：

方案1：字符串字面量注解（全Python版本兼容） #

直接把还没定义的类型名用引号包裹即可，类型检查工具会自动识别匹配后续定义的类：

class A():
    def funct_one(self, name: str, rec: "B") -> None:
        ...

class B():
    ...

方案2：启用延迟注解（Python 3.7及以上版本推荐） #

在Python文件的最开头添加from __future__ import annotations导入，所有类型注解会默认延迟到整个模块加载完成后再解析，不需要额外给类型名加引号：

from __future__ import annotations

class A():
    def funct_one(self, name: str, rec: B) -> None:
        ...

class B():
    ...

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