PyCharm代码检查未标记继承自存根对象的类中的未解析引用

根因说明 #

你遇到的是PyCharm 2020.3版本针对stub（pyi）文件定义类的静态校验兼容逻辑：该版本默认假定stub中定义的类可能存在运行时动态添加的属性（尤其是PySide2这类绑定C++库的stub，普遍声明了__getattr__方法兼容Qt动态属性机制），因此主动关闭了对应派生类的未解析引用检测。

解决方案 #

1. 调整IDE内置校验配置 #

打开 File > Settings > Editor > Inspections > Python > Unresolved references 检查项：

• 点击右侧配置区域的Options按钮，取消勾选 Suppress unresolved references for classes with getattr defined in stubs
• 将该项的Severity等级调整为你需要的提示强度（如Warning/Error）
• 保存配置后重启IDE即可生效

2. 自定义stub编写规范 #

如果你是自行维护项目内的pyi文件，遵循以下规则即可触发正常校验：

• 不要在类定义中声明__getattr__/__setattr__方法，除非运行时的类确实实现了动态属性逻辑
• 所有实例属性、类属性都添加明确的类型注解，不要仅用...省略属性声明

3. 版本升级修复 #

该问题已被JetBrains认定为bug，在PyCharm 2021.2及后续版本中已完成修复，升级后默认会对stub派生类执行严格的未解析引用校验，无需额外修改配置。

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