本文介绍一种无需重复声明属性即可将 Protocol 类自动转换为可实例化数据类的方法，利用 dataclasses.make_dataclass 与 typing.get_type_hints 动态生成符合协议结构的实体类，适用于测试、Mock 和原型开发场景。
本文介绍一种无需重复声明属性即可将 protocol 类自动转换为可实例化数据类的方法，利用 `dataclasses.make_dataclass` 与 `typing.get_type_hints` 动态生成符合协议结构的实体类，适用于测试、mock 和原型开发场景。
在 Python 类型提示实践中，Protocol 是定义结构化接口（鸭子类型）的有力工具，但它本身不可实例化——这在单元测试或快速原型中常带来不便。例如，当你有一个仅声明属性的协议：
from typing import Protocol
class P(Protocol):
val: int
name: str
active: bool你无法直接执行 P(val=42, name="test", active=True)，因为 TypeError: Protocols cannot be instantiated。虽然可以手动编写一个继承自 object 的数据类并复制所有字段，但这违背了 DRY 原则，且易因协议变更而脱节。
更优雅的解法是动态构建等效数据类：利用 typing.get_type_hints(P) 提取协议中所有带类型注解的公有属性，并交由 dataclasses.make_dataclass 自动生成具备完整 __init__、__repr__ 和 __eq__ 的类。该方法完全避开对 __annotations__ 等内部属性的手动操作，符合 dataclasses 公共 API 设计规范。
以下是推荐实现：
from dataclasses import make_dataclass
from typing import Protocol, get_type_hints
class P(Protocol):
val: int
name: str
active: bool
# 一行代码生成可实例化类
DP = make_dataclass('DP', list(get_type_hints(P).items()))
# ✅ 完全可用
instance = DP(val=42, name="test", active=True)
print(instance) # DP(val=42, name='test', active=True)
print(isinstance(instance, P)) # True —— 满足协议（运行时结构兼容）? 注意：
get_type_hints(P)返回的是Dict[str, type]，而make_dataclass的fields参数接受Iterable[Tuple[str, type, Field]]或Iterable[Tuple[str, type]]。因此我们使用list(...items())转换为(name, type)元组列表即可。
进阶用法中，你还可以为字段添加默认值或 Field 配置：
from dataclasses import field
DP = make_dataclass(
'DP',
[
('val', int),
('name', str, field(default='unnamed')),
('active', bool, field(default=True)),
]
)⚠️ 重要限制说明：
- 此方法仅提取
__annotations__中的类型信息，不支持协议中的方法签名、@property、类变量或ClassVar； - 生成的类是普通数据类，不继承原协议类（
issubclass(DP, P)为False），但实例仍可通过结构匹配满足协议（即isinstance(instance, P)在运行时可能为True，取决于协议复杂度和检查方式）； - 若协议含泛型（如
T: TypeVar），get_type_hints可能返回typing.Any或引发错误，建议在简单协变协议中优先使用。
总结：make_dataclass + get_type_hints 是目前最简洁、安全、符合标准库设计意图的解决方案，让协议从“只读契约”无缝延伸为“可写测试桩”，大幅提升类型驱动开发的效率与可靠性。
