VSCode中Python继承重写方法时，自动补全能否自动导入对应类型提示？

对应场景说明 #

• 开发环境为VSCode，开展Python项目开发
• 正常可用的能力：子类重写父类方法的继承场景下，自动补全可正常运行，能够完整带出父类方法定义的所有类型提示
• 现存问题：补全生成的带类型提示的重写方法代码，不会自动关联导入所有类型对应的依赖模块，存在类型引用缺失问题
• 效果参考：补全触发前的代码状态、补全完成后缺失导入的效果均有对应截图可对照

可实现自动导入的配置步骤 #

VSCode的Python智能感知能力默认基于官方Pylance语言服务，按照以下步骤调整配置，即可实现补全时自动导入所有缺失的关联类型：

基础开关配置 #

打开VSCode设置面板（快捷键Ctrl+,），搜索对应配置项完成调整：

• 开启python.analysis.autoImportCompletions选项。这个配置是实现补全时同步自动导入的核心开关，开启后Pylance在生成补全代码时，会自动检测引用的缺失类型，同步生成对应的导入语句
• 将python.analysis.typeCheckingMode设置为basic或strict模式，该配置会让语言服务更精准地识别所有关联的类型依赖，避免漏判需要导入的类型
• 配置editor.codeActionsOnSave规则，添加source.organizeImports为explicit，保存文件时会自动清理无效导入、补全所有未识别的类型引用导入

特殊场景适配 #

针对子类重写父类方法的补全逻辑，还需要确认两个前置配置避免自动导入失效：

• 确认项目对应的Python解释器路径配置正确，解释器路径不对会导致Pylance无法识别类型对应的模块路径，进而无法生成自动导入语句
• 如果项目依赖了第三方存根类型、自定义公共模块，需要在python.analysis.extraPaths配置中添加所有依赖的模块根路径，保证Pylance能定位到类型对应的导入位置

异常排查清单 #

如果配置完成后功能未生效，按以下顺序排查：

• 确认当前默认Python语言服务为Pylance，旧版的Microsoft Python语言服务不支持重写方法补全场景下的自动导入能力
• 确认VSCode打开的项目根目录层级正确，Pylance的项目识别以打开的根目录为基准，根目录层级错误会导致模块路径识别失败
• 如果项目使用虚拟环境，需要在VSCode右下角手动选择对应虚拟环境的解释器，不要默认使用全局解释器开展开发

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