Python如何实现类似TypeScript的Partial工具类型处理TypedDict？

解决方案 #

Python 已经支持你期望的类似 TypeScript 的 Partial 用法，具体实现方案如下：

方案1：直接使用官方提供的 Partial 泛型（推荐）

适用版本：Python 3.10+ 配合 typing-extensions 4.1.0 及以上版本，主流类型检查工具（mypy、pyright、pytype）均已支持该特性。

from typing_extensions import TypedDict, Partial


class Foo(TypedDict):
    x: int
    y: int


# 完全符合你期望的写法
foo: Partial[Foo] = {'x': 1}

该方案不会改变原 Foo 类型的必填约束，只有标注为 Partial[Foo] 的变量才允许省略属性，完全满足「先声明全必填类型，特定场景使用子集」的需求。

方案2：继承实现（兼容旧版本）

如果运行环境版本较低，无法引入新版的 Partial，可以通过继承 TypedDict 配合 total=False 实现相同效果：

from typing_extensions import TypedDict


# 原全必填类型
class Foo(TypedDict):
    x: int
    y: int

# 派生全可选的子类型
class PartialFoo(Foo, total=False):
    pass


foo: PartialFoo = {'x': 1}

该实现和 Partial[Foo] 效果完全一致，Foo 本身的必填约束不会受到任何影响。

提示：上述 Partial 目前仅对 TypedDict 类型生效，如果你需要对 dataclass、pydantic 模型等其他类型实现类似的部分可选效果，需要使用对应工具库提供的专属能力。

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