Linux环境下pip安装numpy卡在PEP 517 wheel构建阶段无法解决

架构老林

2026-10-4

优先使用预编译wheel包跳过本地构建，执行命令：
```
pip install numpy --only-binary :all:
```
该方案会直接下载官方预构建好的二进制包，不需要本地执行PEP 517的wheel编译流程，90%以上的同类安装卡住问题都可以通过该方法解决。
更换国内PyPI镜像源加速下载，避免因资源拉取缓慢导致的假死，执行命令：
```
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple --only-binary :all:
```
使用Linux发行版自带的包管理器安装官方维护的numpy包，兼容性最高：
Debian/Ubuntu 系列执行：
```
sudo apt update && sudo apt install python3-numpy
```
CentOS/RHEL/Fedora 系列执行：
```
sudo dnf install python3-numpy
```
若确实需要从源码编译安装，先安装完整的编译依赖再执行安装命令：
Debian/Ubuntu 系列先执行：
```
sudo apt install build-essential python3-dev gfortran libopenblas-dev liblapack-dev
```
之后再运行pip install numpy即可。