Python嵌套类引用报错NameError：未定义Enum_1问题求助

这个错误的核心是Python类定义阶段的作用域解析规则：当你在Nested类里直接写feature: Enum_1时，Python会立刻尝试查找Enum_1这个名称，但此时cls_1还没有完成完整的类定义——虽然Enum_1写在Nested前面，但它是cls_1的嵌套类，在Nested的定义范围内，直接引用Enum_1并不会自动关联到外层cls_1的嵌套类，所以会触发NameError。

下面是几种可行的解决方法：

方法1：使用字符串类型注解（Python 3.7+） #

把类型注解用字符串包裹，Python会延迟解析这个类型名称，直到整个cls_1类定义完成：

from enum import Enum
from dataclasses import dataclass

class cls_1:
    class Enum_1(Enum):
        OPTION1 = 1
        OPTION2 = 2

    @dataclass
    class Nested:
        feature: "Enum_1"  # 用字符串包裹类型名

方法2：启用延迟注解解析（Python 3.7+） #

导入from __future__ import annotations，这个特性会让所有类型注解自动以字符串形式存储，直到运行时才解析，彻底解决嵌套类/循环引用的类型注解问题：

from __future__ import annotations
from enum import Enum
from dataclasses import dataclass

class cls_1:
    class Enum_1(Enum):
        OPTION1 = 1
        OPTION2 = 2

    @dataclass
    class Nested:
        feature: Enum_1  # 无需字符串包裹，自动延迟解析

方法3：显式通过主类引用嵌套枚举 #

直接用cls_1.Enum_1作为类型注解，明确指定枚举类的归属：

from enum import Enum
from dataclasses import dataclass

class cls_1:
    class Enum_1(Enum):
        OPTION1 = 1
        OPTION2 = 2

    @dataclass
    class Nested:
        feature: cls_1.Enum_1  # 显式引用主类下的嵌套枚举

这三种方法都能解决你的问题，选哪种取决于你的Python版本和代码风格偏好——方法2最省心，适合长期维护的代码；方法1和3则更灵活，适合临时调整或需要明确类型来源的场景。

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