Python枚举类Enum使用函数作为值行为异常的原因及使用方法

Python 标准库 Enum 的元类在解析枚举类定义时，会默认将类命名空间中所有可调用（callable）且未被特殊标记的对象识别为类方法，而非枚举成员。这个设计的初衷是允许开发者在枚举类中定义普通的实例/类方法，不会被误识别为枚举成员。

你直接将函数赋值给类属性 FOO 时，函数属于可调用对象，因此 Enum 不会把它加入枚举成员列表（即 __members__ 属性中不存在 FOO 记录），只会将其作为普通类方法处理，也就出现了你观察到的现象：

• 直接通过类名访问 FOO 能拿到函数本身、可以正常调用，因为它确实是类的属性
• 遍历枚举、dir() 返回结果中看不到 FOO，因为它没有被识别为合法的枚举成员

根据你使用的 Python 版本，可以选择以下任意一种方案：

方案1：使用 enum.member 装饰器（Python 3.11+ 推荐） #

Python 3.11 新增了 enum.member 装饰器，专门用来显式标记某个可调用对象为枚举成员，而非类方法：

from enum import Enum, member

def foo():
    return 'foo'

class EnumWithFuncs(Enum):
    FOO = member(foo)

也可以直接在枚举类内定义函数时添加装饰器：

class EnumWithFuncs(Enum):
    @member
    def FOO():
        return 'foo'

验证效果：

>>> EnumWithFuncs.FOO
<EnumWithFuncs.FOO: <function foo at 0x104b54550>>
>>> EnumWithFuncs.FOO.value()
'foo'
>>> list(EnumWithFuncs)
[<EnumWithFuncs.FOO: <function foo at 0x104b54550>>]

方案2：使用枚举Functional API（兼容所有Python版本） #

使用 Enum 的函数式创建方式，传入的键值对都会被直接识别为枚举成员，不会触发可调用对象的过滤逻辑：

from enum import Enum

def foo():
    return 'foo'

EnumWithFuncs = Enum("EnumWithFuncs", {"FOO": foo})

方案3：用不可调用容器包裹函数（兼容所有Python版本） #

将函数放到元组、列表等不可调用的容器中，就不会被 Enum 识别为类方法，使用时取出 value 再调用即可：

from enum import Enum

def foo():
    return 'foo'

class EnumWithFuncs(Enum):
    FOO = (foo,)

调用方式：

>>> EnumWithFuncs.FOO.value[0]()
'foo'

内容的提问来源于stack exchange，提问作者d.wsky