Python类内部自引用类型注解为何使用单引号包裹？——以Person类make_friend方法为例

这个问题其实是Python类型注解里很常见的前向引用场景，我来给你拆解清楚：

1. 直接写Person会出什么问题？ #

当你在定义Person类的make_friend方法时，Python解释器是从上到下逐行执行代码的。当解析到def make_friend(self, friend: Person) -> None:这一行时，Person类本身还没有完全定义完成——类的定义代码还在执行中，此时Person这个名称还没有绑定到实际的类对象上，直接写Person会触发NameError，因为解释器找不到这个名称。

而用单引号包裹成'Person'就不一样了：字符串形式的类型注解不会在定义时被立刻求值，Python会把它当作一个“占位符”，告诉类型检查工具（比如mypy、pyright）“这个参数的类型就是我们正在定义的这个Person类”，而不会在运行时抛出错误。

2. 这种单引号注解是怎么生效的？ #

这其实是PEP 484（Python类型提示规范）里明确规定的前向引用写法：

• 在Python 3.7之前，如果你要引用还未定义的类型（包括当前正在定义的类），必须用字符串形式；
• 从Python 3.7开始，你可以通过导入from __future__ import annotations，让所有类型注解自动以字符串形式存储，这时候你直接写friend: Person也不会报错，因为注解会被延迟解析；
• 如果你需要在运行时获取类型注解的实际类型，可以用typing.get_type_hints()函数，它会自动把字符串形式的注解解析成对应的类对象。

3. 和类型类快捷方式有关系吗？ #

完全没关系。类型类快捷方式通常指的是像list[str]代替List[str]（Python 3.9+支持的内置泛型注解）这类简化写法，而我们这里用单引号包裹是纯粹为了解决类定义未完成时的引用问题，和快捷方式没有任何关联。

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