VS Code开发Python时缺失导入无快速修复的问题排查

检查Pylance核心配置 #

• 开启python.analysis.autoImportCompletions：打开VS Code设置（快捷键Ctrl+,），搜索该选项并确保处于勾选状态。这是Pylance提供第三方包自动导入补全的核心开关，默认可能未开启。
• 配置python.analysis.extraPaths：若你的依赖包安装在非标准路径（比如未被自动识别的虚拟环境），手动添加包所在的site-packages路径。示例配置：

  "python.analysis.extraPaths": ["venv/lib/python3.10/site-packages"]
  

确认Python环境匹配 #

• 检查左下角状态栏的Python环境选择器，确保选中的是已安装sqlalchemy的虚拟环境/全局环境。环境不匹配会导致Pylance无法扫描到第三方包。
• 打开VS Code内置终端，运行pip list确认当前环境下sqlalchemy已存在，避免终端环境与编辑器选中环境不一致。

刷新Pylance缓存 #

• 按Ctrl+Shift+P打开命令面板，输入Python: Restart Language Server重启Pylance服务。缓存堆积可能导致包识别延迟，重启后会重新扫描环境中的所有依赖包。

标记源码根目录 #

• 若项目依赖包不在默认扫描路径，右键点击包所在目录，选择Add Folder to Workspace，或在设置中配置python.analysis.sourceRoots指定源码根路径，让Pylance能正确索引第三方包结构。

升级Pylance插件 #

你当前使用的Pylance版本为2023.8.30，建议升级到最新版本。新版本通常会修复第三方包识别的兼容性问题，提升自动补全的准确性。

内容的提问来源于stack exchange，提问作者Florian Wörister