PyCharm无法重构@unique装饰的跨文件枚举成员？是否为预期行为？

这是PyCharm的Bug，并非@unique装饰器的固有特性。

原因说明 #

@unique装饰器仅负责校验枚举类中成员值的唯一性，不会修改枚举类的结构、成员定义方式或可访问性。Python解释器完全能正常识别并处理被该装饰器修饰的枚举成员，但PyCharm的代码分析引擎在处理跨文件定义的、被@unique装饰的枚举类时出现了识别异常，无法追踪成员的引用关系，因此无法提供重构/重命名的上下文选项。

验证依据 #

• 移除枚举类上的@unique装饰器后，PyCharm可正常识别枚举成员的引用，右键菜单会恢复重构/重命名选项；
• 若将被@unique装饰的枚举类与使用代码放在同一文件中，PyCharm也能正常处理成员的引用和重构操作。

临时解决办法 #

1. 若无需校验枚举成员唯一性，可暂时移除@unique装饰器，完成重构后再重新添加；
2. 手动替换所有枚举成员的引用（适合引用较少的场景）；
3. 升级PyCharm至更高版本（JetBrains在后续2023.x版本中已修复类似的枚举识别问题）。

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