Windows11下PyCharm虚拟环境安装scikit-sparse编译失败求助

环境与错误信息 #

• 系统：x64架构Windows11 Home
• Python环境：PyCharm中Python3.7.9虚拟环境
• 错误现象：安装scikit-sparse时无法构建wheel，核心错误为：

  fatal error C1083: Cannot open include file: 'cholmod.h': No such file or directory
  

  完整栈追踪中还出现额外错误：

  c:\users\caiul\appdata\local\programs\python\python37\include\pyconfig.h(203): fatal error C1083: Cannot open include file: 'basetsd.h': No such file or directory
  

解决方案 #

方法1：使用预编译wheel包（最简便） #

Windows下编译scikit-sparse依赖的SuiteSparse库步骤繁琐，优先采用预编译二进制wheel包：

• 找到匹配Python3.7、x64架构的scikit-sparse wheel文件
• 在虚拟环境中执行安装命令：

  pip install 下载的wheel文件名.whl
  

方法2：修复Visual Studio构建工具的缺失文件 #

针对basetsd.h找不到的问题，补充Windows SDK组件：

• 打开Visual Studio Installer，找到已安装的Visual Studio 2015（对应栈中VC14.0版本），点击「修改」
• 确保勾选Windows 10 SDK（建议选择与栈中版本10.0.10240.0兼容或更高的版本），完成安装
• 若未安装VS2015，可直接安装Microsoft Visual C++ Build Tools 2015，包含必要的SDK头文件

方法3：手动指定SuiteSparse依赖路径（编译安装） #

如果必须从源码编译，需先安装SuiteSparse库：

• 下载SuiteSparse库（包含CHOLMOD组件）并解压到本地路径
• 安装时通过参数指定include和lib路径：

  pip install scikit-sparse --global-option=build_ext --global-option="-IC:\你的SuiteSparse路径\include" --global-option="-LC:\你的SuiteSparse路径\lib"
  

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