已解决：ERROR: Could not build wheels for bottleneck, which is required to install pyproject.toml-based

这种错误常见于在安装依赖于 pyproject.toml 格式的 Python 项目时，其中某些依赖库需要编译步骤，但由于某些原因，编译未能成功。具体原因可能包括缺少编译环境、缺少必要的依赖库等。以下是一些常见的解决方案。

---

🧑 博主简介：现任阿里巴巴嵌入式技术专家，15年工作经验，深耕嵌入式+人工智能领域，精通嵌入式领域开发、技术管理、简历招聘面试。CSDN优质创作者，提供产品测评、学习辅导、简历面试辅导、毕设辅导、项目开发、C/C++/Java/Python/Linux/AI等方面的服务，如有需要请站内私信或者联系任意文章底部的的VX名片（ID：gylzbk）

💬 博主粉丝群介绍：① 群内高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

问题背景

在使用 pip 安装 Python 包时，可能会遇到类似如下的错误：

ERROR: Could not build wheels for bottleneck, which is required to install pyproject.toml-based projects

这种错误常见于在安装依赖于 pyproject.toml 格式的 Python 项目时，其中某些依赖库需要编译步骤，但由于某些原因，编译未能成功。具体原因可能包括缺少编译环境、缺少必要的依赖库等。以下是一些常见的解决方案。

安装必要的编译工具和库

1. 安装基础编译工具

确保你的系统已经安装了基础编译工具：

Windows

在 Windows 上，可以安装 Build Tools for Visual Studio：

• 下载并安装 Build Tools for Visual Studio
• 勾选“C++ build tools”工作负载

macOS

在 macOS 上，可以安装 Xcode 命令行工具：

xcode-select --install

Linux

在 Linux 上，需要安装开发工具包：

Debian/Ubuntu 系列

sudo apt update
sudo apt install build-essential
sudo apt-get install python3-dev python3-setuptools python3-pip

RedHat/CentOS 系列

sudo yum groupinstall 'Development Tools'
sudo yum install python3-devel

2. 安装numpy和cython

Bottleneck库依赖于 numpy, 因此你需要提前安装 numpy。另外，cython也是有时会用到的。

pip install numpy cython

3. 使用pip的–no-build-isolation选项

尝试通过添加--no-build-isolation选项来安装库。这一选项将使用当前环境的依赖包，而不是隔离的构建环境。这适用于已安装了所需依赖但构建时隔离环境无法访问的情况。

pip install bottleneck --no-build-isolation

4. 更新pip、setuptools和wheel

确保你的 pip、setuptools 和 wheel 都是最新版本，因为它们处理编译任务。

pip install --upgrade pip setuptools wheel

综合示例

为确保完整性，你可以按以下步骤运行所有命令：

Windows

1. 安装 Build Tools for Visual Studio
2. 更新 pip、setuptools 和 wheel
3. 安装 numpy 和 cython
4. 安装目标包

pip install --upgrade pip setuptools wheel
pip install numpy cython
pip install bottleneck --no-build-isolation

macOS

1. 安装 Xcode 命令行工具
2. 更新 pip、setuptools 和 wheel
3. 安装 numpy 和 cython
4. 安装目标包

xcode-select --install
pip install --upgrade pip setuptools wheel
pip install numpy cython
pip install bottleneck --no-build-isolation

Linux（以Ubuntu为例）

1. 安装开发工具包
2. 更新 pip、setuptools 和 wheel
3. 安装 numpy 和 cython
4. 安装目标包

sudo apt update
sudo apt install build-essential python3-dev python3-setuptools python3-pip
pip install --upgrade pip setuptools wheel
pip install numpy cython
pip install bottleneck --no-build-isolation

其他可能的解决方案

1. 使用虚拟环境

如果你的Python环境配置可能导致冲突，建议使用虚拟环境，以确保安装过程中的隔离性。

python -m venv myenv
source myenv/bin/activate  # Unix/macOS
myenv\Scripts\activate     # Windows

然后在虚拟环境中运行安装命令。

2. 使用 Anaconda

如果以上方法仍然无法解决问题，可以考虑使用Conda环境来安装相关包。Conda环境中常常有预编译的二进制包，避免了编译问题。

conda install -c anaconda bottleneck

总结

在解决“ERROR: Could not build wheels for bottleneck, which is required to install pyproject.toml-based projects”错误时，通常需要确保系统上安装了必要的编译工具和库，如 build-essential、python3-dev、numpy 和 cython。更新 pip、setuptools 和 wheel 也是一个有效的解决方案。尝试使用 --no-build-isolation 选项来安装库，或使用虚拟环境和 Conda 进行安装也可以解决部分问题。希望本文提供的解决方案能够帮助你顺利解决编译错误，提高开发效率。如果有任何疑问或进一步的问题，欢迎在评论区留言讨论！