typeddict 仅用于静态类型检查，运行时不校验字典；字段默认必填，可选需用 notrequired 显式声明；无运行时反射机制，无法用 isinstance 判断；继承需谨慎，不支持动态校验。
TypedDict 不能在运行时校验字典
TypedDict 只是给类型检查器（如 mypy、pylance）提供提示，它不会在运行时做任何校验。你写一个完全不符合定义的字典，Python 解释器照常执行，不会报错，只有 mypy 这类工具会在静态分析阶段提示问题。
常见错误现象：my_dict = {"name": 42, "age": "hello"} 却没被 Python 报错——这不是 bug，是 TypedDict 的设计本意。
- 使用场景：主要配合 mypy 做 IDE 提示和 CI 阶段类型检查，不是替代
pydantic或dataclasses的运行时校验 - 参数差异：TypedDict 是纯类型构造器，不接受
__init__、不生成实例方法，不能用isinstance(my_dict, MyDict)判断 - 性能影响：零开销，因为所有信息在运行时被擦除
定义必填与可选字段要显式声明
默认所有字段都是必填的；想设为可选，必须用 typing.NotRequired（Python 3.11+）或 typing.Optional + 注释方式（不推荐），否则 mypy 会把缺失字段当错误。
示例：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
from typing import TypedDict, NotRequired <p>class User(TypedDict): name: str age: int email: NotRequired[str] # 显式标记可选 </p>
- Python typing_extensions.NotRequired，直接 pip install typing_extensions
- 别用
email: Optional[str]—— 这表示“值可以是None”，不是“字段可以不存在” - mypy 对
NotRequired的支持要求开启--strict或至少--warn-return-any等相关检查项
运行时判断字典是否符合 TypedDict？没有内置办法
TypedDict 没有运行时反射机制，isinstance(d, User) 会报 TypeError: isinstance() argument 2 cannot be a parameterized generic；issubclass(type(d), User) 同样无效。
- 如果真需要运行时校验，请换用
pydantic.BaseModel或手写校验函数 - 临时 workaround：用
dict.keys() >= User.__annotations__.keys()粗略检查字段名（但无法校验类型或可选性） - 注意
User.__annotations__返回的是字符串化类型（如'str'），不是实际类型对象，不能直接用于isinstance(value, ann)
继承和扩展 TypedDict 容易踩类型合并陷阱
TypedDict 支持继承，但子类新增字段默认仍是必填，且父类的 NotRequired 字段在子类中不会自动变成必填——这点容易误判。
示例：
class Base(TypedDict):
id: int
<p>class Extended(Base):
name: str # ✅ 必填
desc: NotRequired[str] # ✅ 仍可选
</p>
- 不能用
class Extended(Base, total=False)来批量设为可选——total=False只在定义时生效，不能用于继承 - 多个父类继承时，字段名冲突会导致 mypy 报错，且不支持“覆盖”语义
- 如果要用动态结构，不如考虑
NamedTuple或@dataclass（它们有运行时行为，但失去纯字典的灵活性）
TypedDict 的价值全在编辑器提示和静态检查链路里，一旦离开 mypy 就“隐身”。很多人卡在以为它能拦住 bad data，其实它连 json.loads() 后的字典都不会碰一下。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
