使用pip安装Python模块时遇wheel构建错误，该如何解决？

一、升级核心工具 #

先确保pip、wheel、setuptools是最新版本，旧版本可能不兼容pyproject.toml格式的项目：

pip install --upgrade pip wheel setuptools

二、安装系统级编译依赖 #

这类编译失败通常是因为缺少C/C++编译工具或底层依赖库，按你的操作系统执行以下步骤：

Windows #

安装Visual Studio构建工具，勾选「C++开发工具」组件（包含MSVC编译器、Windows SDK等），安装完成后重启终端再尝试安装。
如果使用conda环境，可直接安装预编译包跳过编译：

conda install -c conda-forge srsly preshed thinc blis

macOS #

安装Xcode命令行工具：

xcode-select --install

若仍报错，通过Homebrew安装OpenBLAS依赖：

brew install openblas

Linux（Debian/Ubuntu 系列） #

更新包列表并安装编译工具和依赖：

sudo apt-get update
sudo apt-get install build-essential python3-dev libopenblas-dev

RHEL/CentOS 系列：

sudo yum groupinstall "Development Tools"
sudo yum install python3-devel openblas-devel

三、尝试预编译轮子 #

如果编译始终失败，可直接下载对应Python版本和系统架构的预编译.whl文件（从PyPI获取），手动安装：

# 示例：假设下载了srsly-2.4.8-cp310-cp310-manylinux_2_17_x86_64.whl
pip install srsly-2.4.8-cp310-cp310-manylinux_2_17_x86_64.whl

依次安装preshed、thinc、blis的预编译包后，再安装目标模块。

四、使用干净的虚拟环境 #

避免全局环境依赖冲突，创建并激活虚拟环境后再安装：

python -m venv myenv
# Windows 激活
myenv\Scripts\activate
# macOS/Linux 激活
source myenv/bin/activate
# 安装目标模块
pip install [你的模块]

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