Python 中的 enum.EnumNonMember 装饰器用于标记枚举类中的非成员属性，确保这些属性不会被误识别为枚举成员，默认情况下，枚举类会将所有类属性视为成员，但有时需要定义辅助方法或类变量，此时使用 @enum.nonmember 装饰器可以明确排除这些属性，避免与枚举值冲突，在定义工具方法或缓存数据时，该装饰器能清晰区分功能代码与枚举逻辑，其用法简单，只需在非成员属性上添加装饰器即可，从而提升代码可读性和维护性，这一特性在复杂枚举场景中尤为重要，帮助开发者更精准地控制枚举行为。

Python 的 enum 模块提供了一种强大的方式来定义枚举类型，使代码更具可读性和可维护性，在 enum 模块中，@enum.EnumNonMember 是一个相对较少被提及但非常有用的装饰器，它允许开发者将某些值排除在枚举成员之外，同时仍然保留它们的可用性，本文将详细介绍 @enum.EnumNonMember 的作用、使用场景以及如何正确应用它。

---

什么是 @enum.EnumNonMember？

@enum.EnumNonMember 是 Python 3.11 引入的一个装饰器，用于标记某些类属性，使其不被视为枚举成员，但仍然可以在类中访问，这意味着被装饰的值不会出现在枚举的迭代、__members__ 字典或其他枚举相关操作中,但它们仍然可以作为普通类属性使用。

基本语法

from enum import Enum, EnumNonMember
class MyEnum(Enum):
    MEMBER1 = 1
    MEMBER2 = 2
    @EnumNonMember
    def helper_method(self):
        return f"Helper for {self.name}"

在这个例子中，helper_method 不会被当作枚举成员,但仍然可以在枚举实例上调用。

---

@enum.EnumNonMember 的作用

1 防止非枚举值干扰枚举操作

枚举通常用于表示一组固定的常量值，如果类中包含一些辅助方法或属性，它们可能会被错误地当作枚举成员处理，导致 for member in MyEnum 或 MyEnum.__members__ 包含不必要的项。@EnumNonMember 可以避免这种情况。

2 保持枚举的纯净性

枚举的设计初衷是提供一组有限的、不可变的值，如果枚举类中包含动态计算的方法或临时变量，使用 @EnumNonMember 可以确保这些额外的逻辑不会破坏枚举的语义。

3 提高代码可读性

通过显式地标记哪些属性不是枚举成员，代码的意图更加清晰，其他开发者可以更容易理解哪些是枚举值,哪些是辅助功能。

---

使用场景

1 枚举类中的辅助方法

假设我们有一个 Color 枚举，并希望提供一个方法来计算颜色的 RGB 分量：

from enum import Enum, EnumNonMember
class Color(Enum):
    RED = (255, 0, 0)
    GREEN = (0, 255, 0)
    BLUE = (0, 0, 255)
    @EnumNonMember
    def rgb_to_hex(self):
        return f"#{self.value[0]:02x}{self.value[1]:02x}{self.value[2]:02x}"
print(Color.RED.rgb_to_hex())  # 输出: #ff0000
print(list(Color))  # 输出: [<Color.RED: (255, 0, 0)>, <Color.GREEN: ...>, ...]

rgb_to_hex 方法不会出现在 Color.__members__ 或 list(Color) 中,但仍然可以正常调用。

2 枚举类中的常量

有时我们希望在枚举类中定义一些常量,但不希望它们成为枚举成员：

class HttpStatus(Enum):
    OK = 200
    NOT_FOUND = 404
    @EnumNonMember
    def MAX_STATUS_CODE(self):
        return 599
print(HttpStatus.OK)  # 输出: <HttpStatus.OK: 200>
print(HttpStatus.MAX_STATUS_CODE)  # 输出: 599
print(list(HttpStatus))  # 输出: [<HttpStatus.OK: 200>, <HttpStatus.NOT_FOUND: 404>]

MAX_STATUS_CODE 不会被当作枚举成员,但仍然可以访问。

---

与 @property 和 @classmethod 的结合使用

@EnumNonMember 可以与其他装饰器（如 @property 或 @classmethod）一起使用：

class FileType(Enum):
    TXT = "text"
    PDF = "pdf"
    @EnumNonMember
    @classmethod
    def supported_extensions(cls):
        return {member.value for member in cls}
print(FileType.supported_extensions())  # 输出: {'text', 'pdf'}
print(list(FileType))  # 输出: [<FileType.TXT: 'text'>, <FileType.PDF: 'pdf'>]

---

注意事项

1. Python 3.11+ 支持：@EnumNonMember 仅在 Python 3.11 及以上版本可用，在早期版本中，可以使用 @property 或 @classmethod 结合 @enum.nonmember（如果可用）。
2. 避免滥用：枚举的主要用途是定义一组固定值，过多的辅助方法可能会使枚举类变得臃肿,建议合理使用。
3. 与 @enum.member 对比：@EnumNonMember 的反义词是 @enum.member，它强制将某个属性标记为枚举成员（即使它看起来像方法）。

---

@enum.EnumNonMember 是一个有用的装饰器,适用于以下场景：

• 在枚举类中定义辅助方法,但不希望它们成为枚举成员。
• 在枚举类中存储常量,但不希望它们被枚举迭代包含。
• 提高代码可读性,明确区分枚举值和辅助属性。

通过合理使用 @EnumNonMember，可以保持枚举的纯净性，同时增强其功能性和可维护性，如果你正在使用 Python 3.11+，建议在需要时尝试这个装饰器,以优化枚举类的设计。

---

参考链接：

• Python enum 官方文档
• PEP 435 — 枚举类型