Anaconda Spyder环境下Python自定义类属性自动补全异常问题

• 首先排查最易忽略的笔误：你定义的存储RiskProfile实例的字典名为RISKS（末尾带s），但测试补全时输入的是RISK[profile].（末尾缺失s），名称不匹配时补全引擎无法关联到对应对象的类型信息，自然不会弹出属性候选。
• 排除笔误的话，核心原因是Spyder默认搭载的Jedi静态补全引擎的推断机制限制：
  • Jedi生成补全候选时不会实际运行代码，仅靠静态扫描当前工作区内已保存的代码逻辑推断变量、容器的类型。如果SP字典的赋值语句（即SP[员工邮箱] = EmployeeProfile(数据)这类逻辑）在当前文件的可扫描范围内，Jedi能明确识别SP字典存储的所有值都是EmployeeProfile类实例，输入SP[xxx].时就能正常列出类的所有属性供选择。
  • 如果RISKS字典的赋值逻辑存在以下任意一种情况，Jedi就无法正确推断字典值的类型：赋值代码写在未被索引的外部模块/文件中、赋值逻辑包裹在条件分支/动态执行语句（eval/exec）内、编写补全代码前还未写入RISKS[风险ID] = RiskProfile(数据)的明确赋值语句、字典初始化后被重新赋值过其他类型的值。此时Jedi会将RISKS的值类型判定为通用Any类型，自然不会弹出特定类的属性补全列表。
• 手动输入属性名可以正常运行是Python动态类型的特性：运行时会直接读取实例的真实属性，和静态分析阶段的类型推断结果无关，这也是动态语言IDE补全不稳定的典型表现。

• 首先修正笔误，补全时输入正确的字典名RISKS[profile].，确保和定义的变量名完全一致。
• 最稳定的一劳永逸方案是给字典添加明确的类型标注，让Jedi不需要依赖扫描赋值逻辑就能直接识别值类型，示例如下：

from typing import Dict

# 初始化字典时直接添加类型标注
SP: Dict[str, EmployeeProfile] = {}
RISKS: Dict[str, RiskProfile] = {}

添加标注后，无论赋值逻辑写在哪个位置，Jedi都能明确识别两个字典的键为字符串类型、值为对应自定义类的实例，输入字典取值加.时会稳定弹出所有类属性的补全候选。

• 如果不想添加类型标注，可以在RISKS字典初始化的位置后写一行测试赋值语句（写完可以注释掉，不需要实际运行），例如RISKS['test'] = RiskProfile({})，Jedi扫描到这行代码后就能推断出RISKS存储的是RiskProfile实例，补全功能会恢复正常。
• 临时需要补全时，也可以将光标停在.后按Spyder默认的手动补全快捷键Ctrl+Space，强制Jedi重新扫描上下文做类型推断。

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