Python Enum类qualname参数含义与pickle序列化问题咨询

你的判断基本是准确的，qualname的核心作用就是标记枚举类的限定查找路径，主要服务于pickle序列化/反序列化场景。

• 核心结论先给：你提到的Enum('Animal', 'ANT BEE CAT DOG', qualname='SomeData.Animal')写法，在pickle兼容性层面和直接在SomeData类内部定义Animal枚举完全等价，就是专门用来解决函数式创建的枚举作为类属性时，反序列化找不到类的问题。
• 先讲清楚为什么需要手动传这个参数：
  用class关键字定义类的时候，Python会自动根据类的嵌套位置生成正确的__qualname__属性——比如你在SomeData类内部写class Animal(Enum): ...，Python自动就会把这个Animal类的__qualname__设为SomeData.Animal，不需要你手动干预。
  但用函数式调用Enum()动态创建枚举的时候，构造逻辑执行时，返回的枚举类还没被绑定到SomeData.Animal这个属性上，Enum构造器根本感知不到自己的返回值最终会被赋值到哪个命名空间，自动生成的__qualname__只会是Animal，没有外层的SomeData前缀。
• 这就会直接导致pickle的问题：
  pickle协议4反序列化对象的时候，需要靠__module__找到对应模块，再靠__qualname__顺着命名空间路径找到对应的类。如果__qualname__不对，它就会跑到模块全局作用域找名叫Animal的类，自然找不到，这时候要么直接禁用该枚举的pickle能力，要么反序列化直接抛错。
• 你给出的参考代码就是正确用法：

  class SomeData:
      Animal = Enum('Animal', 'ANT BEE CAT DOG', qualname='SomeData.Animal')
  

  手动传入qualname='SomeData.Animal'之后，这个动态创建的枚举类的__qualname__就和嵌套类定义的效果完全一致，pickle就能顺着路径正确找到SomeData类下的Animal属性，正常完成反序列化。
• 补充一个容易踩的坑：
  不要觉得“我明明把Enum返回值赋值给了SomeData的Animal属性，Python应该能自己推断到路径”——赋值动作是在Enum构造完成之后才执行的，构造过程中根本拿不到外层类的命名空间信息，所以只要你用函数式创建的枚举不是直接定义在模块全局作用域，都需要手动传对qualname参数。

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