
当多个嵌套枚举类使用相同名称(如 Manufacturer)时,type() 默认输出无法体现其完整归属路径;本文介绍通过自定义 __repr__ 或继承可复用基类,使枚举实例打印时显示完全限定名(__qualname__),从而直观区分类型来源。
当多个嵌套枚举类使用相同名称(如 `manufacturer`)时,`type()` 默认输出无法体现其完整归属路径;本文介绍通过自定义 `__repr__` 或继承可复用基类,使枚举实例打印时显示完全限定名(`__qualname__`),从而直观区分类型来源。
在 Python 中,嵌套在不同外层类中的同名枚举(如 Car.Manufacturer 和 Plane.Manufacturer)虽然逻辑隔离、类型互不兼容,但调用 type(enum_member) 时仅显示
要解决这一问题,关键在于让枚举成员的字符串表示能反映其完全限定名(__qualname__),该属性保留嵌套结构信息(例如 'Car.Manufacturer' 或 'Plane.Manufacturer')。以下是两种推荐方案:
✅ 方案一:为单个枚举类定制 __repr__
直接在枚举内部重写 __repr__ 方法,利用 type(self).__qualname__ 获取带路径的类名:
from enum import IntEnum
class Car:
class Manufacturer(IntEnum):
BMW = 0
AUDI = 1
def __repr__(self):
return f"<enum {type(self).__qualname__!r}>"
class Plane:
class Manufacturer(IntEnum):
AIRBUS = 0
BOEING = 1
def __repr__(self):
return f"<enum {type(self).__qualname__!r}>"
print(Car.Manufacturer.BMW) # <enum 'Car.Manufacturer'>
print(Plane.Manufacturer.AIRBUS) # <enum 'Plane.Manufacturer'>✅ 方案二:定义可复用的基类(推荐用于多处场景)
避免重复代码,创建一个通用的 QualEnum 混合类,所有需增强显示的枚举均继承它:
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
立即学习“Python免费学习笔记(深入)”;
from enum import IntEnum
class QualEnum:
def __repr__(self):
return f"<enum {type(self).__qualname__!r}>"
class Car:
class Manufacturer(QualEnum, IntEnum): # 注意:必须放在 IntEnum 前以确保方法解析顺序正确
BMW = 0
AUDI = 1
class Plane:
class Manufacturer(QualEnum, IntEnum):
AIRBUS = 0
BOEING = 1
print(Car.Manufacturer.BMW) # <enum 'Car.Manufacturer'>
print(Plane.Manufacturer.AIRBUS) # <enum 'Plane.Manufacturer'>
print(type(Car.Manufacturer.BMW) == type(Plane.Manufacturer.AIRBUS)) # False(类型仍严格区分)⚠️ 注意事项:
- __qualname__ 是 Python 3.3+ 引入的属性,准确反映类在模块/嵌套结构中的完整路径,比 __module__ + '.' + __name__ 更可靠;
- 继承顺序很重要:QualEnum 必须置于 IntEnum(或其他 Enum 子类)之前,否则 __repr__ 可能被父类覆盖;
- 此修改仅影响字符串表示(如 print()、交互式环境输出),不改变类型行为或比较逻辑——isinstance、==、type() is 等仍按实际类型精确工作。
通过上述任一方式,开发者可在调试、日志或交互式开发中一眼识别枚举成员的真实归属,显著提升代码可读性与可维护性。

















