VSCode Python自动导入不提示外部依赖库导入项如何解决

你之前配置的python.autoComplete.extraPaths不控制quick fix场景下的自动导入逻辑，且路径配置层级错误，是配置无效的核心原因。按以下步骤操作即可恢复外部库的自动导入提示：

• 首先确认选中正确的Python解释器
  点击VSCode右下角状态栏的Python版本标识，在弹出的解释器列表中，选中你安装了目标外部库的conda环境，对应路径为/opt/homebrew/Caskroom/miniforge/base/envs/myenv/bin/python。Pylance默认会自动索引当前选中解释器下site-packages目录内所有已安装的第三方库，正常场景下不需要手动额外配置包路径。

• 修正settings.json配置项
  打开VSCode用户/工作区设置的settings.json文件，删除之前添加的错误python.autoComplete.extraPaths配置，补充以下配置：

  {
      // 指定使用Pylance作为Python语言服务器，不要使用旧版退役的语言服务
      "python.languageServer": "Pylance",
      // 开启自动导入补全功能
      "python.analysis.autoImportCompletions": true,
      // 针对重度依赖的外部库调整索引深度，确保所有类、方法都能被检索到
      "python.analysis.packageIndexDepths": [
          {
              "name": "mylib",
              "depth": 4,
              "includeAllSymbols": true
          }
      ]
  }
  

• 重启语言服务生效
  按快捷键Cmd+Shift+P调出命令面板，执行Pylance: Restart Language Server命令，等底部状态栏的Pylance索引进度加载完成后，再输入未导入的外部库类名，触发quick fix（Cmd + .）即可看到对应外部库的导入建议。

1. python.autoComplete.extraPaths仅对最基础的文本补全生效，完全不参与自动导入功能的符号索引逻辑，无法解决quick fix的导入建议缺失问题
2. 你配置的路径写到了site-packages/mylib层级，而非site-packages根目录，会干扰Python的包搜索逻辑，反而导致库无法被正常识别
3. 如果你的外部库是未通过pip安装的私有包，要确保包的各级目录下存在符合规范的__init__.py文件，否则Pylance不会将其识别为可导入的Python包

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