Skip to content

枚举(Enum)

一句话解释

Enum 创建命名常量——用可读、类型安全的符号名称替代魔术数字/字符串。

用大白话说

Enum(枚举)是一个具有固定命名常量成员集合的类。你不用魔术数字(status = 2),而是使用可读名称(status = Status.ACTIVE)。枚举防止无效值、提高可读性并启用 IDE 自动补全。通过 EnumName.MEMBER 或 EnumName['MEMBER'] 访问成员。每个成员有 .name 和 .value。变体:IntEnum(与整数比较)、StrEnum(Python 3.11+,字符串成员)、Flag/IntFlag(可按位组合)。使用 @unique 装饰器禁止重复值。

示例

python
from enum import Enum, auto

class Color(Enum):
    RED = 1
    GREEN = 2
    BLUE = 3

class Status(Enum):
    PENDING = auto()   # Auto-assigns 1
    ACTIVE = auto()    # 2
    CLOSED = auto()    # 3

print(Color.RED)           # Color.RED
print(Color.RED.value)     # 1
print(Color["GREEN"])      # Color.GREEN
print(Status.ACTIVE.name)  # ACTIVE

# Iteration
for c in Color:
    print(c)

枚举提供带 .name 和 .value 的命名常量。auto() 自动赋值。可用 for 循环迭代。

常见混淆

  • 容易混淆的对象: 常量

    关键区别: 普通常量(RED = 1)只是没有分组或类型安全的变量——任何值都可以赋值。枚举将相关常量分组、防止无效值、支持迭代并提供 .name/.value 内省。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表