求助：VSCode无法识别已安装的Python库与模块

• 重启Python语言服务
  打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入Python: Restart Language Server执行，快速修复语言服务缓存问题。

• 校验解释器路径一致性
  激活虚拟环境后，在终端执行which python（Linux/macOS）或where python（Windows）获取解释器路径，确认该路径与VSCode右下角显示的解释器路径完全匹配。若不匹配，重新在VSCode中手动选择该路径的解释器。

• 配置项目搜索路径
  在项目根目录创建.vscode/settings.json文件，添加以下配置，将项目根目录纳入Python分析路径：

  {
      "python.analysis.extraPaths": [
          "${workspaceFolder}"
      ]
  }
  

  此操作可让VSCode识别项目内自定义模块。

• 重新安装虚拟环境依赖
  激活venv后，执行pip install -r requirements.txt（若有依赖清单文件），重新安装所有库，避免安装过程中可能出现的路径异常。

• 清除VSCode缓存
  关闭VSCode，删除对应路径的缓存文件：

  • Windows：%APPDATA%\Code\Cache、%APPDATA%\Code\CachedData
  • macOS：~/Library/Caches/Code、~/Library/Application Support/Code/CachedData
  • Linux：~/.cache/code、~/.config/Code/CachedData
    重启VSCode后再次检查。

• 更新Python插件
  打开VSCode扩展面板，找到Microsoft出品的Python插件，更新至最新版本，旧版本可能存在兼容性问题，更新后重启VSCode。

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