如何为Python Enum枚举字段添加弃用警告并返回对应新字段

首先修正你原有枚举中的拼写错误：Filed3应为Field3，以下是完整可运行的实现：

import enum
import warnings

class MyEnum(enum.Enum):
    # 弃用成员映射：key为弃用的字段名/值，value为替换的目标字段名，可扩展多个弃用项
    _DEPRECATED_MAPPING = {
        "Field2": "Field3"
    }

    Field1 = "Field1"
    Field3 = "Field3"

    def __new__(cls, value):
        # 拦截 MyEnum("Field2") 这种通过值实例化的场景
        if value in cls._DEPRECATED_MAPPING:
            target_name = cls._DEPRECATED_MAPPING[value]
            warnings.warn(
                f"{cls.__name__}.{value} 已被弃用，请使用 {cls.__name__}.{target_name} 代替",
                DeprecationWarning,
                stacklevel=2
            )
            return getattr(cls, target_name)
        # 正常创建枚举实例的逻辑
        obj = object.__new__(cls)
        obj._value_ = value
        return obj

    @classmethod
    def __getattr__(cls, name):
        # 拦截 MyEnum.Field2 这种属性访问的场景
        if name in cls._DEPRECATED_MAPPING:
            target_name = cls._DEPRECATED_MAPPING[name]
            warnings.warn(
                f"{cls.__name__}.{name} 已被弃用，请使用 {cls.__name__}.{target_name} 代替",
                DeprecationWarning,
                stacklevel=2
            )
            return getattr(cls, target_name)
        raise AttributeError(f"{cls.__name__} 没有属性 {name}")

    @classmethod
    def __getitem__(cls, name):
        # 拦截 MyEnum['Field2'] 这种下标访问的场景
        if name in cls._DEPRECATED_MAPPING:
            target_name = cls._DEPRECATED_MAPPING[name]
            warnings.warn(
                f"{cls.__name__}['{name}'] 已被弃用，请使用 {cls.__name__}['{target_name}'] 代替",
                DeprecationWarning,
                stacklevel=2
            )
            return cls[target_name]
        return super().__getitem__(name)

注意：实现中移除了原本定义的Field2枚举成员，因为如果保留该成员，属性访问时会直接命中现有成员，不会触发自定义的拦截逻辑。

测试效果 #

# 属性访问场景
print(MyEnum.Field2)
# 输出：MyEnum.Field3，同时触发弃用警告

# 值实例化场景
print(MyEnum("Field2"))
# 输出：MyEnum.Field3，同时触发弃用警告

# 下标访问场景
print(MyEnum["Field2"])
# 输出：MyEnum.Field3，同时触发弃用警告

# 正常字段不受影响
print(MyEnum.Field1)
print(MyEnum.Field3)

• 枚举类魔法方法重载：enum.Enum和普通Python类一样支持自定义魔法方法，__new__拦截实例化逻辑、__getattr__拦截属性访问、__getitem__拦截下标访问，三个方法覆盖了所有枚举成员的取值场景。
• 标准库警告系统：warnings模块提供标准化的弃用警告能力，stacklevel=2参数可以让警告的调用栈指向用户实际调用的代码位置，而非枚举内部逻辑，符合Python开发规范。

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