Python字典引用未定义类报错，类型注解却正常，如何解决？

问题原因 #

from __future__ import annotations 仅对类型注解生效——它会将注解内容转为字符串延迟解析，所以c : ClassB不会报错。但字典children是类属性的直接赋值语句，会在ClassC定义时立即执行，此时ClassB还未被定义，因此触发NameError。

可行解决方案 #

方案1：将字典转为实例属性，在__init__中赋值

把children的初始化移到类的构造方法里，这样会在ClassB定义完成后才执行赋值：

from __future__ import annotations

class ClassA:
    pass

class ClassC:
    c : ClassB
    def __init__(self):
        self.children = {'A': ClassA, 'B': ClassB}

class ClassB:
    pass

优点：逻辑直观，无需额外操作；缺点：children变为实例属性，每个ClassC实例会单独持有一份字典。

方案2：先初始化字典的部分内容，后续补充未定义的类

先定义只包含已存在类的字典，等ClassB定义完成后，再给ClassC的类属性补充赋值：

from __future__ import annotations

class ClassA:
    pass

class ClassC:
    c : ClassB
    children = {'A': ClassA}

class ClassB:
    pass

# 在ClassB定义完成后补充条目
ClassC.children['B'] = ClassB

优点：保持children为类属性，所有实例共享同一份字典；缺点：需要拆分赋值步骤。

方案3：用lambda延迟加载类（不推荐，需额外调用）

通过lambda表达式延迟对ClassB的引用，直到实际访问时才求值：

from __future__ import annotations

class ClassA:
    pass

class ClassC:
    c : ClassB
    children = {'A': ClassA, 'B': lambda: ClassB}

class ClassB:
    pass

# 使用时需调用lambda获取类
b_class = ClassC.children['B']()

注意：这种方式需要使用者明确调用lambda函数才能拿到ClassB类，不够直观，仅适合特殊场景。

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