Windows下VS Code虚拟环境.venv安装Scipy失败求助

问题描述 #

我是工科学生，在Windows系统的VS Code中尝试为虚拟环境.venv安装Scipy 1.9.1时失败，报错信息如下：

Collecting scipy==1.9.1
  Using cached scipy-1.9.1.tar.gz (42.0 MB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... error
  error: subprocess-exited-with-error

终端同时提示虚拟环境激活相关问题：

Failed to activate VS environment: Could not find C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe

已尝试更换Scipy版本、安装vswhere包等方案，均无效，寻求解决办法。

解决步骤 #

1. 安装Visual Studio Build Tools #

Scipy在Windows下编译依赖MSVC编译环境，vswhere.exe是Visual Studio安装器的核心组件，缺失说明未安装必要的编译工具：

• 下载并运行Visual Studio Installer，在工作负载中勾选**“桌面开发使用C++”**，确保包含以下组件：
  • MSVC v142及以上版本的生成工具
  • 对应你Windows版本的Windows SDK
  • C++ CMake工具
• 安装完成后重启电脑，重新激活虚拟环境再尝试安装Scipy。

2. 手动配置vswhere路径（若已安装但路径异常） #

如果已安装Visual Studio但vswhere.exe不在默认的x86路径：

• 找到Visual Studio Installer的实际安装目录，通常为C:\Program Files\Microsoft Visual Studio\Installer（64位路径）
• 将该路径添加到系统环境变量PATH中
• 重启VS Code和终端，激活虚拟环境后重新执行安装命令。

3. 强制使用预编译轮子跳过编译 #

不想安装编译工具的话，可直接让pip使用预编译的Scipy包：

• 激活虚拟环境后，执行命令：

python -m pip install --only-binary :all: scipy==1.9.1

这条命令会强制pip下载预编译的.whl文件，无需本地编译，避开对MSVC环境的依赖。

4. 重建虚拟环境 #

若以上方法无效，可能是当前虚拟环境损坏：

• 删除现有的.venv文件夹
• 在VS Code中打开命令面板（Ctrl+Shift+P），选择“Python: 创建虚拟环境”，选择对应版本的Python
• 激活新虚拟环境后，执行pip install scipy==1.9.1

内容的提问来源于stack exchange，提问作者Louis-Frédéric Petitjean