无法构建nmslib的wheel：基于pyproject.toml的项目安装失败求助

算力阿峰

2026-7-5

解决nmslib编译失败问题

报错信息

ERROR: Failed building wheel for nmslib
Failed to build nmslib
ERROR: Could not build wheels for nmslib, which is required to install pyproject.toml-based project

已尝试操作

从Git安装nmslib、spacy、scispacy，错误仍未解决。

解决方案

编译nmslib失败大多是因为缺少系统级编译依赖或工具版本不兼容，试试以下步骤：

安装系统编译依赖
根据你的操作系统执行对应命令：
- Ubuntu/Debian：
```
sudo apt-get install build-essential cmake libboost-all-dev
```
- CentOS/RHEL：
```
sudo yum groupinstall "Development Tools" && sudo yum install cmake boost-devel
```
- Windows：安装Visual Studio并勾选「C++开发工具」组件，或配置MinGW环境并添加到系统PATH
升级pip、setuptools、wheel
旧版本工具可能导致编译失败，先升级：
```
pip install --upgrade pip setuptools wheel
```
指定兼容版本安装nmslib
部分新版本nmslib存在编译兼容性问题，尝试安装稳定旧版本：
```
pip install nmslib==2.1.1
```
手动从源码编译安装
如果上述方法都不行，手动编译源码：
1. 克隆源码仓库：
```
git clone https://github.com/nmslib/nmslib.git
```
2. 进入目录并创建编译环境：
```
cd nmslib && mkdir build && cd build
```
3. 配置编译参数：
```
cmake ..
```
4. 编译并安装到系统：
```
make && sudo make install
```
5. 安装Python绑定：
```
cd ../python_binding && pip install .
```