如何在Python内部类中定义嵌套TypedDict？

要实现嵌套内部类形式的TypedDict，让SomeDict的id字段支持SomeIdFieldDict或None，可以按以下几种方式解决：

1. 调整内部类定义顺序（最简便） #

出现NameError通常是因为你把依赖方（SomeDict）放在了被依赖方（SomeIdFieldDict）前面。只要把被引用的SomeIdFieldDict先定义，就能直接在SomeDict里引用：

from typing import TypedDict, Optional

class Outer:
    # 先定义被依赖的内部TypedDict
    class SomeIdFieldDict(TypedDict):
        id_str: str
        type: str

    # 再定义依赖它的TypedDict
    class SomeDict(TypedDict):
        id: Optional[SomeIdFieldDict]

2. 用字符串字面量注解（无法调整顺序时） #

如果因为双向引用等原因不能调整顺序，可以用字符串形式引用后续定义的内部类，类型检查器（如mypy、pyright）能正确识别：

from typing import TypedDict, Optional

class Outer:
    class SomeDict(TypedDict):
        # 用字符串引用后续定义的SomeIdFieldDict
        id: Optional["SomeIdFieldDict"]

    class SomeIdFieldDict(TypedDict):
        id_str: str
        type: str

注意：如果你的Python版本低于3.7，需要加上from __future__ import annotations来让字符串注解生效。

3. 显式使用ForwardRef（兼容旧版本或复杂场景） #

对于更复杂的场景，或者Python 3.6及以下版本，可以用ForwardRef显式声明引用：

from typing import TypedDict, Optional, ForwardRef

class Outer:
    # 声明对后续类的引用
    SomeIdFieldDictRef = ForwardRef("SomeIdFieldDict")

    class SomeDict(TypedDict):
        id: Optional[SomeIdFieldDictRef]

    class SomeIdFieldDict(TypedDict):
        id_str: str
        type: str

# 显式解析引用（Python 3.9+可通过get_type_hints自动处理）
from typing import get_type_hints
get_type_hints(Outer.SomeDict)

为什么你之前的方法出错？ #

• 直接引用触发NameError：定义SomeDict时，SomeIdFieldDict还未被创建，Python找不到该名称。
• 字符串引用触发TypeError：大概率是写法错误，比如未将字符串包裹在Optional中，或者类名拼写错误。
• 顶层类引用无效：可能是引用路径错误，正确路径应为Outer.SomeIdFieldDict而非直接写SomeIdFieldDict。
• 内联定义被识别为Any：内联TypedDict是匿名结构，类型检查器无法追踪其字段，因此最好单独定义为内部类。

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