get_type_hints() 默认只作用于传入的类型对象（如 B），而非实例（如 b）；若传入实例，它会退化为获取该实例所属类的 __annotations__（不包含父类），因此无法自动合并继承链上的类型提示。
`get_type_hints()` 默认只作用于传入的**类型对象**（如 `b`），而非实例（如 `b`）；若传入实例，它会退化为获取该实例所属类的 `__annotations__`（不包含父类），因此无法自动合并继承链上的类型提示。
在 Python 中使用 typing.get_type_hints() 获取数据类（@dataclass）的完整类型注解时，一个常见误区是将实例对象（例如 b = B(...)）直接传给 get_type_hints()。这种用法看似合理，实则违背其设计契约：get_type_hints() 的第一个参数应为类型（type），而非实例（object）。
根据 Python 官方文档 及其实现逻辑，当传入实例（如 get_type_hints(b)）时，函数内部会调用 obj.__class__ 获取其类型，并仅检查该类型的 __annotations__ 属性——而 __annotations__ 在数据类中默认不继承父类字段注解，导致子类 B 的 __annotations__ 仅包含 'b': int，丢失了从 A 继承的 'a': int。
✅ 正确做法是显式传入类本身：
from dataclasses import dataclass, fields
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(B)) # {'a': <class 'int'>, 'b': <class 'int'>}
# ❌ 错误：传入实例，仅返回 B.__annotations__
b = B(a=4, b=5)
print(get_type_hints(b)) # {'b': <class 'int'>} —— 遗漏父类字段但需注意：即使传入 get_type_hints(B)，其结果是否包含父类注解，仍取决于 Python 版本与 dataclass 的实现细节。自 Python 3.11 起，dataclass 会自动将父类字段注解合并到子类的 __annotations__ 中（前提是父类也是 @dataclass）；而在更早版本（如 3.10 及以前），B.__annotations__ 依然仅包含自身字段，此时 get_type_hints(B) 也不会自动递归合并父类注解。
? 因此，若需跨版本兼容、可靠获取完整继承字段的类型信息，推荐组合使用 dataclasses.fields() 与 get_type_hints()：
from dataclasses import fields, is_dataclass
from typing import get_type_hints, Dict, Any
def get_all_type_hints(cls: type) -> Dict[str, Any]:
"""安全获取数据类及其所有父类数据类字段的完整类型注解"""
if not is_dataclass(cls):
raise TypeError(f"{cls} is not a dataclass")
hints = {}
# 从 MRO 逆序遍历（先子类后父类），避免覆盖同名字段
for base in reversed(cls.__mro__):
if is_dataclass(base) and hasattr(base, '__annotations__'):
# 对每个基类，用 get_type_hints 安全提取其注解（支持字符串前向引用等）
base_hints = get_type_hints(base)
hints.update(base_hints)
return hints
# 使用示例
print(get_all_type_hints(B))
# 输出: {'a': <class 'int'>, 'b': <class 'int'>}⚠️ 注意事项：
- get_type_hints() 会解析字符串字面量注解（如 'List[int]'）并求值，若模块未导入对应类型，可能抛出 NameError；建议配合 globalns/localns 参数或使用 eval 安全上下文（生产环境慎用）；
- fields(B) 返回的是 Field 对象列表，包含名称、类型、默认值等元信息，适合需要字段级控制的场景（如序列化、验证），但不处理泛型或字符串注解；
- 若只需字段名和类型，且确定所有父类均为 @dataclass，[f.name for f in fields(B)] 和 get_type_hints(B)（Python ≥3.11）已足够简洁；否则，上述 get_all_type_hints() 是更鲁棒的通用方案。
总结：get_type_hints(b) 是误用，应改为 get_type_hints(B)；但要真正“获取继承链上全部字段的类型”，不能仅依赖单一函数——需结合 is_dataclass、__mro__ 和 get_type_hints 手动聚合，才能确保跨版本一致性与类型安全性。
