get_type_hints() 需作用于类对象（如 B）而非实例（如 b），才能递归解析父类注解；直接传入实例将仅返回该实例所属类的直接注解，忽略继承链。
`get_type_hints()` 需作用于类对象（如 `b`）而非实例（如 `b`），才能递归解析父类注解；直接传入实例将仅返回该实例所属类的直接注解，忽略继承链。
在 Python 数据类（@dataclass）的类型反射场景中，一个常见误区是误将 typing.get_type_hints() 应用于实例对象，期望它自动聚合继承链上的所有字段类型注解。但根据 官方文档 和源码实现，get_type_hints() 的第一个参数应为类型（type），例如 get_type_hints(B)，而非实例 get_type_hints(b)。
当传入实例时（如 get_type_hints(b)），函数内部会通过 obj.__class__ 获取其类型，但不会主动向上遍历 MRO（Method Resolution Order）合并父类的 __annotations__ —— 它仅对目标类自身的 __annotations__ 进行求值（包括对字符串字面量、from __future__ import annotations 下延迟解析的支持），而不会递归合并基类注解。
✅ 正确做法：对类本身调用 get_type_hints
from dataclasses import dataclass
from typing import get_type_hints
@dataclass
class A:
a: int = 0
@dataclass
class B(A):
b: int = 0
# ✅ 正确：传入类 B，而非实例 b
print(get_type_hints(A)) # {'a': <class 'int'>}
print(get_type_hints(B)) # {'a': <class 'int'>, 'b': <class 'int'>}⚠️ 注意事项：
立即学习“Python免费学习笔记（深入）”；
- get_type_hints() 默认不合并继承注解，但它能正确读取类自身的 __annotations__ —— 而 @dataclass 在定义子类时，会自动将父类字段注入子类的 __annotations__（前提是父类也是 @dataclass）。因此 get_type_hints(B) 能得到完整字段，本质是因为 B.__annotations__ 已包含 'a' 和 'b'。
- 验证这一点可直接检查：
print(B.__annotations__) # {'a': <class 'int'>, 'b': <class 'int'>} - 若父类 A 未使用 @dataclass，则 B.__annotations__ 不会自动包含 a，此时 get_type_hints(B) 也不会回溯到 A 的注解。此时需手动合并（例如遍历 B.__mro__ 并累加各 __annotations__）。
- dataclasses.fields(b) 返回的是运行时字段对象列表（含默认值、类型等元信息），它总是包含继承字段（因为 fields() 内部已处理 MRO），适用于需要字段描述符的场景；而 get_type_hints() 更适合纯类型推导与静态分析。
? 总结：
要获取继承数据类的完整类型注解映射，请始终对类对象（如 B）调用 get_type_hints()；若需字段级元数据（如默认值、init/repr 标志等），则 fields(B) 或 fields(instance) 是更可靠的选择。二者定位不同：前者面向类型系统，后者面向数据类运行时结构。
