Python跨包定义相同枚举（Enum）为何会出现不兼容问题？

这个问题其实是Python枚举的一个常见“坑”，核心原因是即使两个枚举类的代码完全一样，只要它们属于不同的模块/包，Python就会把它们当成完全独立的类，它们的实例自然也不被视为同一个对象——这就是你遇到KeyError的根本原因。

具体原因拆解： #

1. 枚举类的身份独立性
   Python中，每个类（包括Enum类）的身份是由它的定义位置（模块、类名等）决定的，而非类的内容。你在parser包中定义的NodeFace，和导入者本地文件中定义的NodeFace，是两个完全不同的类对象——哪怕它们的成员、值、名字全一样。

   你可以在调试时运行这几行代码验证：

   # 假设从parser包导入的枚举
   from your_parser_package import NodeFace as ParserNodeFace
   # 本地的枚举
   from your_local_module import NodeFace as LocalNodeFace
   
   print(ParserNodeFace.TOP == LocalNodeFace.TOP)  # 输出 False！
   print(type(ParserNodeFace.TOP))  # 输出 <class 'your_parser_package.NodeFace'>
   print(type(LocalNodeFace.TOP))   # 输出 <class 'your_local_module.NodeFace'>
   print(hash(ParserNodeFace.TOP))  # 哈希值和本地实例完全不同
   

   可见两个TOP实例打印结果一致，但所属类完全不同，哈希值也不一样，自然无法作为同一个键在字典中匹配。

2. 为什么打印/调试看起来一样？
   枚举类的__repr__和__str__方法只会输出<NodeFace.BOTTOM: 1>这类格式，只显示枚举成员的名字和值，不会显示它所属的模块或类的身份信息，所以肉眼看起来完全一致，但底层是不同的对象。

3. KeyError的直接原因
   你的OppositeFace字典中，所有键都是本地NodeFace类的实例；而从parser输出字典拿到的tface，是parser包中NodeFace类的实例。这两个实例属于不同的类，哈希值不同，字典找不到对应键，就抛出了KeyError。

更优的解决方案（除了你用的字符串转换法）： #

你当前“转成字符串再转成本地枚举”的方法是可行的，除此之外还有更直接的方案：

• 共享枚举定义：把NodeFace枚举单独放在一个独立的公共模块/包中，让parser和导入者都从这个公共模块导入NodeFace。这样两边用的是同一个枚举类，实例自然完全兼容，从根源上避免问题。
• 通过value转换实例：如果无法共享枚举定义，可以把parser传来的枚举实例，通过它的value转成本地枚举的实例：

  # 把parser来的tface转成本地NodeFace实例
  local_tface = NodeFace(tface.value)
  # 之后用local_tface去查OppositeFace就没问题了
  if OppositeFace[local_tface] == pface:
      # ...你的逻辑
  

总结 #

Python中类的身份由其定义的上下文（模块、类路径）决定，相同内容的不同枚举类是完全独立的，它们的实例无法互相替代作为字典键或进行相等性比较（Enum默认的相等性比较是基于身份的）。你的解决思路是对的，而共享枚举定义是从根源上避免这类问题的最佳实践。

备注：内容来源于stack exchange，提问作者Leon Starr