TypedDict类设置默认值的最佳实践是什么？（附代码示例）

TypedDict 是 Python 中用于静态类型检查的工具，运行时本质就是普通字典，所以直接给它加 __init__ 构造方法是无效的——因为它不会像普通类那样实例化，自定义的构造逻辑根本不会被执行。下面是几种靠谱的实现方式：

1. 工厂函数封装（推荐） #

写一个专门的函数来创建符合 TypedDict 类型的字典，通过函数参数设置默认值，既保留类型提示，又完全兼容 JSON 序列化/反序列化：

from typing import TypedDict

class A(TypedDict):
    a: int
    b: int

def create_A(a: int = 0, b: int = 1) -> A:
    return {"a": a, "b": b}

# 使用示例
default_obj = create_A()  # 得到 {"a": 0, "b": 1}
custom_obj = create_A(a=3)  # 得到 {"a": 3, "b": 1}

2. 类方法封装 #

如果想让调用方式更贴近类的使用习惯，可以给 TypedDict 类添加一个类方法来生成带默认值的字典：

from typing import TypedDict

class A(TypedDict):
    a: int
    b: int

    @classmethod
    def with_defaults(cls, a: int = 0, b: int = 1) -> "A":
        return cls({"a": a, "b": b})

# 使用示例
default_obj = A.with_defaults()

3. 可选字段场景适配 #

如果允许部分字段可选（即字典可以缺省某些键），可以先给 TypedDict 设置 total=False，再结合工厂函数填充默认值：

from typing import TypedDict

class A(TypedDict, total=False):
    a: int
    b: int

def create_A(a: int = 0, b: int = 1) -> A:
    return {"a": a, "b": b}

这种方式既满足类型检查对可选字段的定义，又能确保返回的字典包含所有需要的键和默认值。

内容的提问来源于stack exchange，提问作者Gil Ben David