Pylance无法识别新安装pip包 无需重启VS Code怎么解决

核心原因 #

该问题是Pylance默认不会实时更新包索引缓存，新安装的包没有被加入扫描列表，重启VS Code实际是触发了缓存的全量重建。

可落地的解决方法 #

• 快速重载无需全量重启：按Ctrl+Shift+P（Mac系统为Command+Shift+P）调出命令面板，搜索执行Reload Window，仅重载窗口即可触发缓存更新，耗时远少于完整重启VS Code
• 调整Pylance扫描配置：打开VS Code设置页，搜索以下选项修改：
  1. 开启python.analysis.autoSearchPaths，允许Pylance自动扫描环境下的新包路径
  2. 修改python.analysis.packageIndexDepths配置，提高全局包索引深度，示例配置如下（可直接粘贴进JSON配置文件）：

     "python.analysis.packageIndexDepths": [
         {
             "name": "",
             "depth": 5,
             "includeAllSymbols": true
         }
     ]
     

  3. 关闭python.analysis.delayPackageLoad选项，禁用包延迟加载，让Pylance启动时就全量扫描所有已安装包，缺点是大型项目首次加载速度会略有下降
• 手动触发环境重新扫描：安装完新包后，点击VS Code底部状态栏显示的当前Python解释器版本，在弹出的列表中重新选择一次你正在使用的环境，即可触发Pylance重新扫描该环境下的所有已安装包

临时绕过方案 #

如果不需要永久修复，可直接点击报错导入语句旁的黄色灯泡，选择忽略该导入的缺失警告即可，不会影响代码实际运行。

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