get_type_hints() 默认只作用于传入的类对象本身，而非实例；若想获取子类 B 的全部字段（含父类 A 的注解），应传入类 B 而非实例 b，再结合 dataclasses.fields() 或递归解析继承链以补全注解。
get_type_hints() 默认只作用于传入的**类对象本身**，而非实例；若想获取子类 `b` 的全部字段（含父类 `a` 的注解），应传入类 `b` 而非实例 `b`，再结合 `dataclasses.fields()` 或递归解析继承链以补全注解。
在使用 Python dataclasses 时，一个常见误区是误将实例（如 b = B(...)）作为 typing.get_type_hints() 的参数。该函数的设计语义明确：它接收一个类型（type）、可调用对象或模块，而非实例。因此，get_type_hints(b) 实际等价于 get_type_hints(type(b))，但 type(b) 是 B，而 B.__annotations__ 本身不自动继承父类 A.__annotations__ —— 这是 Python 类机制的底层行为：__annotations__ 是类字典，不会合并父类注解。
验证如下：
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 → 虽然不报错，但逻辑上等同于 get_type_hints(B)，且易引发误解
b = B(1, 2)
print(get_type_hints(b)) # 行为上等价，但语义错误、不可靠、不推荐然而，需注意：get_type_hints(B) 能返回完整注解的前提是——父类 A 也是 @dataclass 且定义了类型注解。这是因为 dataclass 装饰器会确保 __annotations__ 在类创建时被正确设置，并在 get_type_hints() 内部通过 getattr(cls, '__annotations__', {}) 获取后，再沿 __mro__ 向上查找未覆盖的注解（get_type_hints 自 v3.9+ 已支持对类的继承式注解解析）。
但若需更健壮、显式地获取所有字段（含默认值、类型、是否为继承字段等元信息），推荐组合使用 dataclasses.fields()：
立即学习“Python免费学习笔记（深入）”；
from dataclasses import fields
# 获取 B 实例的所有字段（含继承自 A 的字段），按定义顺序排列
all_field_names = [f.name for f in fields(B)]
all_field_types = {f.name: f.type for f in fields(B)}
print(all_field_names) # ['a', 'b']
print(all_field_types) # {'a': <class 'int'>, 'b': <class 'int'>}✅ 优势：fields() 原生支持继承，返回 Field 对象，包含类型、默认值、init/repr 等完整元数据，且不依赖 __annotations__ 的手动合并。
⚠️ 注意事项：
- get_type_hints() 对泛型、字符串前向引用（如 'List[int]'）或 from __future__ import annotations 场景更友好，但必须传入类对象；
- 若父类未使用 @dataclass（例如普通基类），则 fields(B) 仍能工作（只要子类是 @dataclass），但 get_type_hints(B) 不会包含父类注解（因父类无 __annotations__ 或未参与 dataclass 字段发现）；
- 避免对实例调用 get_type_hints()：虽当前版本可能“巧合”成功，但属未定义行为，未来版本可能变更或抛出警告。
总结：要安全、清晰地获取继承数据类的全部类型注解，请始终传入类（如 get_type_hints(B)）；若还需字段默认值、初始化配置等上下文，则优先使用 fields(B) —— 它是 dataclass 生态中专为字段发现设计的标准接口，语义准确、行为稳定、兼容性最佳。
