__annotations__ 仅包含类体顶层变量标注（如 id: int），不包含方法参数/返回值或实例属性标注；获取方法类型需用 inspect.signature()，实例属性标注需借助 @dataclass 或自定义描述符。
直接访问 __annotations__ 只能拿到类体顶层的标注
类定义中写在类体内的变量标注（如 name: str），会直接进入 __annotations__ 字典；但方法内部的参数、返回值标注，或实例属性（self.x: int）完全不会出现。这是最常被误解的一点——很多人以为 __annotations__ 是“整个类的所有类型信息总和”，其实它只记录类体中显式声明的变量标注。
例如：
class User:
id: int
name: str = "anonymous"
<pre class="brush:php;toolbar:false;">def greet(self, msg: str) -> str:
return f"Hello, {msg}"
User.__annotations__ 只有 {'id': <class>, 'name': <class>}</class></class>，greet 的参数和返回值标注压根不在里面。
获取方法签名的类型信息得用 inspect.signature()
要拿到 greet(self, msg: str) -> str 的完整类型标注，必须单独处理每个可调用对象。不能靠类的 __annotations__，而要用 inspect 模块解析其签名：
-
inspect.signature(func)返回Signature对象，其中parameters和return_annotation才包含实际标注 - 注意：
self参数的标注（如果写了）也会出现在parameters['self'].annotation中，但通常为inspect.Parameter.empty - 静态方法（
@staticmethod）和类方法（@classmethod）需单独判断，它们没有隐式self或cls标注逻辑
示例：
import inspect sig = inspect.signature(User.greet) print(sig.return_annotation) # <class> print(sig.parameters['msg'].annotation) # <class></class></class>
实例属性标注（self.x: int）根本不会进 __annotations__
这类标注属于表达式语句，Python 解释器在运行时执行 self.x = ...，不收集类型信息。哪怕你写了 self.age: int = 25，它既不会进类的 __annotations__，也不会自动变成 dataclass 字段或 TypedDict 成员。
想让这类标注生效并可反射获取，只有两个现实路径：
- 用
@dataclass（配合init=False或手动__post_init__控制初始化逻辑） - 改用
__set_name__协议自定义描述符，在类创建时主动扫描 AST 或利用typing.get_type_hints配合源码解析（极少见，且不可靠）
别指望运行时靠 __annotations__ 或 getattr 捞到它——它就是个“装饰性注释”，解释器不保留。
typing.get_type_hints() 能补全但依赖上下文
get_type_hints() 可以把字符串形式的前向引用（如 "User"）解析成真实类型，并合并父类标注，但它仍受限于来源：
- 对类体变量：作用对象是类本身，结果接近
__annotations__，但更健壮（处理字符串引用、泛型等） - 对方法：必须传入绑定或非绑定方法对象，例如
get_type_hints(User.greet)，才能拿到参数/返回值标注 - 它不会凭空造出实例属性标注——没定义的地方，它也读不到
典型用法：
from typing import get_type_hints print(get_type_hints(User)) # 类体变量 print(get_type_hints(User.greet)) # 方法签名
真正难的不是怎么取，而是得先分清：这个标注写在哪一层（类体？方法签名？实例赋值？），再选对应工具。混用 __annotations__ 和 get_type_hints 去查方法返回值，或者指望它发现 self.x: int，都会默默失败，且无报错提示。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
