在启用 from __future__ import annotations 后，类型注解支持前向引用，但普通运行时字典值（如 {'A': ClassA, 'B': ClassB}）仍需类已定义，否则抛出 NameError；可通过延迟赋值（如 setdefault 或模块级初始化）安全引入后定义类。
在启用 `from __future__ import annotations` 后，类型注解支持前向引用，但普通运行时字典值（如 `{'a': classa, 'b': classb}`）仍需类已定义，否则抛出 `nameerror`；可通过延迟赋值（如 `setdefault` 或模块级初始化）安全引入后定义类。
在 Python 类型提示日益普及的今天，from __future__ import annotations 已成为标准实践，它将所有类型注解转为字符串形式，从而允许前向引用（forward reference）——即在类定义之前使用尚未声明的类名作为类型提示。这解释了为何 c: ClassB 能成功通过静态检查（如 mypy）且运行时不报错：它本质上被存储为字符串 "ClassB"，而非立即求值。
然而，运行时对象构造不享受此豁免。例如：
class ClassC:
c: ClassB # ✅ 类型注解：延迟解析，合法
children: dict = {'A': ClassA, 'B': ClassB} # ❌ 运行时报 NameError！
此处 {'B': ClassB} 是字典字面量，在 ClassC 类体执行时即被求值，而此时 ClassB 尚未定义，因此触发 NameError: name 'ClassB' is not defined。
✅ 正确解决方案：延迟初始化字典值
最简洁、符合 Python 惯用法的方式是分离声明与赋值：先在类中定义字典骨架（仅含已存在类），再在类定义完成后，通过模块级语句动态注入后续定义的类：
from __future__ import annotations
class ClassA:
pass
class ClassC:
c: ClassB
children: dict = {"A": ClassA} # 只放入已定义的 ClassA
class ClassB:
pass
# ✅ 在 ClassB 定义后，安全添加到字典
ClassC.children["B"] = ClassB
# 或更健壮地使用 setdefault（避免覆盖已有键）
# ClassC.children.setdefault("B", ClassB)
该方案优势明显：
- 零运行时开销：仅一次属性赋值；
- 清晰可维护：逻辑分离，意图明确；
- 兼容所有 Python 版本（≥3.7 + annotations）；
- 不影响类型检查：ClassC.children 的类型仍可标注为 Dict[str, Type[Union[ClassA, ClassB]]]（需配合 typing.Type 和 typing.Union）。
? 补充说明与最佳实践
- 若字典需在类实例化前就完整可用（如用于工厂模式），可将初始化逻辑移至类方法或 __init_subclass__ 中；
- 避免使用 eval() 或 globals()["ClassB"] 等动态求值方式——破坏可读性、阻碍静态分析，且存在安全隐患；
- 对于复杂场景（如多层级前向依赖），推荐采用注册器（registry）模式，统一管理类映射关系。
总之，理解“类型注解延迟解析”与“运行时表达式即时求值”的根本区别，是解决此类问题的关键。始终让运行时数据结构的构建时机匹配其依赖项的生命周期。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
