本文介绍如何通过抽象基类实现多个 typeddict 类型的构造函数逻辑复用，利用类属性动态指定允许的字段集，避免重复代码，同时保持类型安全和运行时字段过滤能力。
本文介绍如何通过抽象基类实现多个 typeddict 类型的构造函数逻辑复用，利用类属性动态指定允许的字段集，避免重复代码，同时保持类型安全和运行时字段过滤能力。
在 Python 类型驱动开发中，TypedDict 是表达结构化字典类型的重要工具，而当多个类需基于不同 TypedDict 接收并校验 **kwargs 时，直接复制构造函数逻辑会导致维护困难。理想方案是提取共用初始化逻辑至基类，并让子类声明其专属的字段白名单——这正是“签名继承”的核心诉求。
以下是一个简洁、可扩展且类型友好的实现：
from typing import TypedDict, Union, Unpack, Dict, Any
class TypeFilter1(TypedDict):
c: str
d: float
class TypeFilter2(TypedDict):
e: float
f: int
# 支持 N 个 TypedDict 的通用基类
class BaseClass:
# 子类必须覆写此属性，值为对应 TypedDict.__annotations__
ALLOWED_FIELDS: Dict[str, Any] = {}
def __init__(self, **kwargs: Union[Unpack[TypeFilter1], Unpack[TypeFilter2]]) -> None:
filtered = self._filter_kwargs(kwargs)
self.filters = [f"{k}:{v}" for k, v in filtered.items()]
self.params = " ".join(self.filters)
def _filter_kwargs(self, kwargs: Dict[str, Any]) -> Dict[str, Any]:
"""按子类声明的 ALLOWED_FIELDS 过滤 kwargs，仅保留合法键"""
return {k: v for k, v in kwargs.items() if k in self.ALLOWED_FIELDS}
class MyClass1(BaseClass):
ALLOWED_FIELDS = TypeFilter1.__annotations__
class MyClass2(BaseClass):
ALLOWED_FIELDS = TypeFilter2.__annotations__✅ 使用示例：
a = MyClass1(c="hello", d=2.0) # params → "c:hello d:2.0" b = MyClass2(e=2.1, f=42, g=999) # params → "e:2.1 f:42"（g 被自动忽略）
? 关键设计说明：
立即学习“Python免费学习笔记（深入）”；
- **kwargs: Union[Unpack[TypeFilter1], Unpack[TypeFilter2]] 提供了静态类型检查支持（Pyright / mypy ≥ 1.5），提示 IDE 识别合法关键字参数；
- ALLOWED_FIELDS 作为类属性而非类型参数，规避了 TypeVar + Unpack[T] 在运行时不可用的限制；
- _filter_kwargs 方法解耦了“字段校验”与“实例构建”，便于子类定制（如添加类型转换或默认值填充）；
- 扩展至 N 个 TypedDict 仅需新增子类并设置 ALLOWED_FIELDS = YourFilter.__annotations__，零侵入修改基类。
⚠️ 注意事项：
- TypedDict.__annotations__ 在运行时是 dict，但其键名与类型定义严格一致，适合做字段存在性校验；
- 若需更强健的类型验证（如检查值是否符合字段类型），建议结合 pydantic.BaseModel 或自定义验证器；
- 当前方案不阻止传入非法键（仅静默过滤），若需报错，可将 del 替换为 raise TypeError(f"Unexpected keyword argument: {k}")。
该模式平衡了类型提示能力、运行时灵活性与工程可维护性，是处理多态 **kwargs 初始化场景的推荐实践。
