VSCode中Python虚拟环境下SpeechRecognition包无法识别求助

核心排查与解决步骤 #

• 确认VSCode选中正确的虚拟环境解释器
  按Ctrl+Shift+P打开命令面板，输入Python: Select Interpreter，选择myproject/.venv/Scripts/python.exe（对应你的3.7.0虚拟环境）。可通过VSCode左下角状态栏确认当前使用的解释器版本和环境。

• 配置Pylance识别虚拟环境包路径
  打开VSCode设置（Ctrl+,），搜索python.analysis.extraPaths，点击「编辑 in settings.json」，添加虚拟环境的site-packages路径：

  "python.analysis.extraPaths": [
      "${workspaceFolder}/.venv/Lib/site-packages"
  ]
  

  保存设置后重新加载窗口。

• 确保包安装到虚拟环境内
  激活虚拟环境后，在终端执行pip --version，确认输出的pip路径指向.venv/Scripts/pip.exe。如果不是，直接用虚拟环境的pip重新安装包：

  .venv/Scripts/pip.exe install SpeechRecognition PyAudio
  

• 重新加载VSCode窗口
  按Ctrl+Shift+P，输入Developer: Reload Window，让配置生效。

长期优化（避免反复出现此类问题） #

在项目根目录创建.vscode/settings.json文件，写入以下配置，让VSCode打开项目时自动关联虚拟环境：

{
    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/Scripts/python.exe",
    "python.analysis.extraPaths": [
        "${workspaceFolder}/.venv/Lib/site-packages"
    ]
}

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