如何正确使用Python 3.11的@enum.nonmember装饰器？

语法错误的原因 #

你直接用@enum.nonmember修饰变量赋值C = 3触发语法错误，核心原因是Python装饰器仅能用于修饰函数、方法或类，不能直接作用在变量赋值语句上，这是语法层面的基本限制，和enum.nonmember本身的功能无关。

正确用法示例 #

@enum.nonmember的核心作用是：标记Enum类中的方法/函数不属于枚举成员，不会被纳入枚举的成员集合（比如MyClass.__members__字典）。以下是几种正确的使用方式：

修饰实例方法 #

import enum

class MyClass(enum.Enum):
    A = 1
    B = 2

    @enum.nonmember
    def double_value(self):
        return self.value * 2

修饰类方法/静态方法 #

import enum

class MyClass(enum.Enum):
    A = 1
    B = 2

    @enum.nonmember
    @classmethod
    def list_member_names(cls):
        return [member.name for member in cls]

    @enum.nonmember
    @staticmethod
    def common_helper():
        return "这是一个枚举类的通用辅助函数"

何时需要使用@enum.nonmember #

虽然Enum类中的方法默认不会被当作枚举成员，但以下场景建议显式使用该装饰器：

• 明确语义：清晰标记某个方法不属于枚举成员，避免其他开发者误解，提升代码可读性。
• 自定义Enum元类：如果自定义了Enum元类、修改了枚举成员的识别逻辑，显式标记能确保方法不会被误判为枚举成员。
• 特殊可调用对象：若类中定义了非方法类型的可调用对象（比如自定义可调用类的实例），默认可能被当作枚举成员，此时用@enum.nonmember可排除它。

和property/描述符的区别 #

• property或描述符是用来定义类的动态属性，本身就不会被当作枚举成员，和@enum.nonmember的定位完全不同。
• @enum.nonmember专门针对可调用对象（方法/函数），解决的是“排除枚举成员”的问题，而property解决的是“动态属性访问”的问题。

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