安装scikit-image时wheel构建失败问题求助

问题背景 #

执行命令安装scikit-image：

python -m pip install -U scikit-image 

环境信息：

• 已创建名为env的虚拟环境
• 虚拟环境中已安装numpy
• Python版本：3.11.1

错误表现：编译scikit-image的wheel失败，核心日志摘要：

error: subprocess-exited-with-error
× Building wheel for scikit-image (pyproject.toml) did not run successfully.
│ exit code: 1
╰─> [输出包含numpy.distutils弃用警告、MSVC编译器加载信息，最终提示无法构建wheel]

解决方案 #

1. 降级setuptools版本 #

根据日志提示，numpy.distutils弃用后需搭配setuptools <60.0使用，执行：

pip install setuptools<60.0

2. 安装Windows编译工具（仅Windows环境） #

scikit-image编译依赖C++开发环境，需安装Visual Studio Build Tools，并勾选：

• C++开发工具
• MSVC v142或更高版本的编译器组件
• 对应版本的Windows SDK

安装完成后重启终端，再执行安装命令。

3. 强制使用预编译wheel避免源码编译 #

直接安装预编译的二进制包，跳过源码编译步骤：

pip install -U scikit-image --only-binary :all:

4. 调整numpy版本 #

若当前numpy版本过高引发兼容性问题，可安装兼容Python3.11且保留numpy.distutils的版本：

pip install numpy==1.24.3

之后重新执行scikit-image安装命令。

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