Python中TypedDict子类重写字段类型的替代方案是什么？

在Python的TypedDict规范中，子类不允许重写父类已定义的字段类型，比如以下代码会被Mypy报错：

from typing import TypedDict, Any, List

class ContentBase(TypedDict):
    payload: Any

class ContentA(ContentBase):
    payload: str

class ContentB(ContentBase):
    payload: List[str]

报错信息为：

Overwriting TypedDict field "payload" while extending

而TypeScript允许通过接口继承重写字段类型，示例如下：

interface ContentBase {
  payload: any
}

interface ContentA extends ContentBase {
  payload: string
}

interface ContentB extends ContentBase {
  payload: number
}

在Python中，可以通过以下几种方式实现等价效果：

1. 使用Protocol替代TypedDict #

Protocol是Python用于定义结构契约的类型，支持子类重写属性类型，行为更接近TypeScript的接口：

from typing import Protocol, Any, List

class ContentBase(Protocol):
    payload: Any

class ContentA(ContentBase):
    payload: str

class ContentB(ContentBase):
    payload: List[str]

这种写法能被Mypy正确识别，且允许重写payload的类型。需要注意的是，Protocol适用于所有符合结构的对象（包括类实例、字典等），而TypedDict专门针对字典类型的静态检查，二者用途略有差异。

2. 拆分公共字段，避免继承重写 #

如果必须使用TypedDict，可以将不变的公共字段放在基础类中，把需要差异化的payload字段在子类单独定义：

from typing import TypedDict, List

class ContentBase(TypedDict):
    id: int  # 示例公共字段，根据实际需求调整

class ContentA(ContentBase):
    payload: str

class ContentB(ContentBase):
    payload: List[str]

这种方式严格遵守TypedDict的继承规则，同时实现了不同子类拥有不同payload类型的需求。

3. 用类型别名提取公共字段 #

通过类型别名定义公共字段集合，再让子类TypedDict继承该别名，也能达到类似效果：

from typing import TypedDict, List, TypeAlias

# 提取公共字段为类型别名
CommonContent: TypeAlias = TypedDict('CommonContent', {'id': int})

class ContentA(CommonContent):
    payload: str

class ContentB(CommonContent):
    payload: List[str]

每个子类都会自动包含公共字段，同时拥有自己的payload类型，符合TypedDict的规范。

内容的提问来源于stack exchange，提问作者jetxs