使用 pip install 时 X 的构建轮失败 [已解决]

目录

Failed building wheel for X when using pip install [Solved]

  1. 使用 pip install 时 X 的构建轮失败
  2. psycopg2 构建轮子失败
  3. h5py 构建轮子失败
  4. grpcio 构建轮子失败
  5. 枕头组装轮失败
  6. uwsgi 构建轮子失败
  7. mysqlclient 构建轮子失败
  8. wordcloud 构建轮子失败
  9. llvmlite 构建轮子失败
  10. 火炬的造轮失败

使用 pip install 时 X 构建轮子失败

出现“X 构建轮失败”错误的原因有多种:

  1. wheel环境中没有安装该软件包。
  2. 安装的软件包与我们尝试安装的软件包发生冲突。
  3. 我们尝试安装的软件包不支持 Python 版本。
Failed building wheel for <package-name> Running setup.py clean for <package-name> Failed to build <package-name> Installing collected packages: <package-name> Running setup.py install for <package-name> ... done Successfully installed <package-name>

打开终端并运行以下命令来安装wheel

pip install wheel pip3 install wheel # 👇️ if you don't have pip in your PATH environment variable python -m pip install wheel python3 -m pip install wheel py -m pip install wheel

您还应该升级您的pip.

pip以下是在所有操作系统上进行升级的命令。

哪个命令有效取决于您的操作系统和 Python 版本。
# 👇️ if you have pip already installed pip install --upgrade pip # 👇️ if your pip is aliased as pip3 (Python 3) pip3 install --upgrade pip # 👇️ if you don't have pip in your PATH environment variable python -m pip install --upgrade pip # 👇️ if you don't have pip in your PATH environment variable python3 -m pip install --upgrade pip # 👇️ if you have easy_install easy_install --upgrade pip # 👇️ if you get a permissions error sudo easy_install --upgrade pip # 👇️ if you get a permissions error when upgrading pip pip install --upgrade pip --user # 👇️ upgrade pip scoped to the current user (if you get permissions error) python -m pip install --user --upgrade pip python3 -m pip install --user --upgrade pip # 👇️ Installing directly from get-pip.py (MacOS and Linux) curl https://bootstrap.pypa.io/get-pip.py | python # 👇️ if you get permissions issues curl https://bootstrap.pypa.io/get-pip.py | sudo python # 👇️ alternative for Ubuntu/Debian sudo apt-get update && apt-get upgrade python-pip # 👇️ alternative for Red Hat / CentOS / Fedora sudo yum install epel-release sudo yum install python-pip sudo yum update python-pip

升级 pip 后,setuptools也升级。

pip install --upgrade setuptools pip3 install --upgrade setuptools # 👇️ if you don't have pip in your PATH environment variable python -m pip install --upgrade setuptools python3 -m pip install --upgrade setuptools

安装wheel并升级pip和后setuptools,您应该能够运行该pip install命令而不会出现任何错误。

pip install requests pip3 install requests python -m pip install requests python3 -m pip install requests

如果这没有帮助,请尝试pip install使用该选项运行命令--upgrade

pip install requests --upgrade pip3 install requests --upgrade python -m pip install requests --upgrade python3 -m pip install requests --upgrade

如果错误未解决,请尝试使用
–no-cache-dir选项安装软件包以禁用缓存。

pip install requests --no-cache-dir pip3 install requests --no-cache-dir

如果这没有帮助,请使用--pre包含该包的预发布版本和开发版本的选项。

pip install requests --pre pip3 install requests --pre python -m pip install requests --pre python3 -m pip install requests --pre

--pre选项使其pip包含该包的预发布版本和开发版本。默认情况下pip仅查找稳定版本。

这有时会有所帮助,因为该包的预发布版本可能适用于您的 Python 版本。 wheel

如果错误未解决,请尝试pip install使用该选项运行命令
--no-use-pep517

pip install --no-use-pep517 requests pip3 install --no-use-pep517 requests python -m pip install --no-use-pep517 requests python3 -m pip install --no-use-pep517 requests

如果错误未解决,请通过单击
“Built Distribution”下的文件
wheel
wheel的pypi页面.whl下载包。

下载文件后,在文件所在的文件夹中打开终端.whl
并安装它。

pip install wheel-0.37.1-py2.py3-none-any.whl pip3 install wheel-0.37.1-py2.py3-none-any.whl python -m pip install wheel-0.37.1-py2.py3-none-any.whl python3 -m pip install wheel-0.37.1-py2.py3-none-any.whl

确保指定正确的文件名,.whl因为您的版本可能会有所不同。

从源安装wheel

安装该wheel软件包后,该错误将得到解决。

如果错误未解决,请尝试安装带有
--no-cache-dir禁用缓存选项的软件包。

pip install <package-name> --no-cache-dir pip3 install <package-name> --no-cache-dir

创建虚拟环境

如果这没有帮助,请尝试创建虚拟环境。

  1. 创建虚拟环境。
  2. 激活虚拟环境。
  3. pip install在虚拟环境处于活动状态时运行命令。
# 👇️ use correct version of Python when creating VENV python3 -m venv venv # 👇️ activate on Unix or MacOS source venv/bin/activate # 👇️ activate on Windows (cmd.exe) venv\Scripts\activate.bat # 👇️ activate on Windows (PowerShell) venv\Scripts\Activate.ps1 # 👇️ upgrade pip pip install --upgrade pip # 👇️ install the specific package in the virtual environment pip install requests

确保根据您的操作系统和 shell 使用正确的命令来激活虚拟环境。

您的虚拟环境将使用用于创建它的 Python 版本。

检查包是否支持你的Python版本

您可以使用以下python --version命令检查您的 Python 版本。

python --version

Google 查找包的名称并检查该包是否支持您的 Python 版本。

例如,如果我在 google 上搜索“requests pypi”并单击
pypi.org页面,我可以在左侧边栏中的Meta>下看到受支持的 Python 版本Requires

按包支持的 python 版本

截图显示该包支持Python 3.7+。

如果您的Python版本不满足要求,则会出现错误。

您还可以在包的 pypi 页面的下载文件部分检查包是否支持您的 Python 版本

例如,cp310“Built Distributions”下的文件名称表示特定操作系统支持 Python 版本 3.10。

如果这些.whl文件不适用于您的 Python 版本,请尝试使用该选项运行该pip install命令--pre

pip install requests --pre pip3 install requests --pre python -m pip install requests --pre python3 -m pip install requests --pre py -m pip install requests --pre
确保替换requests为您尝试安装的实际包的名称。

--pre选项使其pip包含该包的预发布版本和开发版本。默认情况下pip仅查找稳定版本。

如果这不起作用,您必须安装指定范围内的 Python 版本,然后运行该pip install <package_name>命令。

您可以通过从
官方 python.org 网站下载安装程序并运行来升级您的 Python 版本。

如果出现提示,请务必勾选以下选项:

  • 为所有用户安装启动器(推荐)
  • 将 Python 添加到 PATH(这会将 Python 添加到您的 PATH 环境变量)

如果包不支持最新的 Python 版本,您可以下载该包支持的特定 Python 版本。

“寻找特定版本”表中提供了不同的版本

安装特定的python版本

尝试在详细模式下运行 pip install

如果所有建议都没有帮助,请尝试pip install在详细模式下运行该命令。

pip install requests -vvv pip3 install requests -vvv python -m pip install requests -vvv

-v选项代表详细模式,最多可以使用 3 次。

当该pip install命令在详细模式下运行时,该命令会显示更多输出以及错误是如何发生的。

要解决“X 构建轮失败”错误,请确保:

  1. 您已wheel通过运行安装了该软件包pip install wheel
  2. 您没有任何与您尝试安装的软件包冲突的软件包。
  3. 该软件包支持您的 Python 版本。

以下是一些导致错误的包的示例

某些软件包要求您先安装某些先决条件,然后才能运行该pip install命令。

以下是导致错误的最常见软件包。

目录

  1. psycopg2 构建轮子失败
  2. h5py 构建轮子失败
  3. grpcio 构建轮子失败
  4. 枕头组装轮失败
  5. uwsgi 构建轮子失败
  6. mysqlclient 构建轮子失败
  7. wordcloud 构建轮子失败
  8. llvmlite 构建轮子失败
  9. 火炬的造轮失败

Python 中因 psycopg2 错误而构建轮子失败

出现“psycopg2 构建轮失败”错误的原因有多种:

  1. 拥有过时版本的pip,setuptoolswheel.
  2. 拥有不受psycopg2-binary.
  3. 安装了与psycopg2-binary模块冲突的软件包。
Failed building wheel for psycopg2 Running setup.py clean for psycopg2 Failed to build psycopg2

要解决该错误,请确保:

  1. 您没有过时版本的pipsetuptoolswheel
  2. 您的 Python 版本不超出psycopg2-binary.

首先,如果您使用的是 Debian (Ubuntu),请确保您已安装psycopg2-binary的所有要求

sudo apt-get install gcc libpq-dev python3-dev

如果您使用的是 macOS,请确保您已openssl安装。

# 👇️ install openssl brew install openssl # 👇️ add it to your LIBRARY_PATH env variable export LIBRARY_PATH=$LIBRARY_PATH:/usr/local/opt/openssl/lib/

openssl位置可能会有所不同,具体取决于您的操作系统,但最常见的是:

  • /usr/local/opt/openssl/lib/
  • /opt/homebrew/opt/openssl/lib

运行以下命令来升级pipsetuptoolswheel

pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel

更新后pipsetuptools运行wheel以下命令进行安装psycopg2-binary

# 👇️ first, uninstall psycopg2 first pip uninstall psycopg2 pip install psycopg2-binary pip3 install psycopg2-binary python -m pip install psycopg2-binary python3 -m pip install psycopg2-binary # 👇️ for Anaconda conda install -c conda-forge psycopg2-binary

如果错误仍然存​​在,请检查
psycopg2-binary.

您可以使用以下python --version命令检查您的 Python 版本。

python --version

您可以在包的 pypi 页面的下载文件部分检查包是否具有可用于特定 Python 版本的轮子。

例如,cp310“Built Distributions”下的文件名称表示特定操作系统支持 Python 版本 3.10。

如果这些.whl文件不适用于您的 Python 版本,您可以下载旧版本。

在 Python 中构建 h5py 的轮子失败

出现“h5py 构建轮失败”错误的原因有多种:

  1. 拥有过时版本的pip,setuptoolswheel.
  2. 拥有不受h5py.
  3. 安装了与h5py模块冲突的软件包。

h5py 构建轮子错误失败

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

要解决该错误,请确保:

  1. 您没有过时版本的pipsetuptoolswheel
  2. 您的 Python 版本不超出h5py.

运行以下命令来升级pipsetuptoolswheel

pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel

更新后pipsetuptools运行wheel以下命令进行安装h5py

pip install h5py pip3 install h5py python -m pip install h5py python3 -m pip install h5py # 👇️ for Anaconda conda install -c conda-forge h5py

当您尝试安装的包不适合wheels您的 Python 版本时,有时会导致该错误。

您可以使用以下python --version命令检查您的 Python 版本。

python --version

您可以在包的 pypi 页面的下载文件部分检查包是否具有可用于特定 Python 版本的轮子。

例如,cp310“Built Distributions”下的文件名称表示特定操作系统支持 Python 版本 3.10。

如果这些.whl文件不适用于您的 Python 版本,您可以下载旧版本。

Python 中因 grpcio 错误而构建轮子失败

出现“grpcio 构建轮失败”错误的原因有多种:

  1. 拥有过时版本的pip,setuptoolswheel.
  2. 拥有不受grpcio.
  3. 安装了与grpcio模块冲突的软件包。
Failed building wheel for grpcio Running setup.py clean for grpcio Failed to build grpcio
如果您使用的是 macOS,请尝试在安装之前将变量设置为 GRPC_PYTHON_BUILD_SYSTEM_OPENSSL GRPC_PYTHON_BUILD_SYSTEM_ZLIB1 truegrpcio
export GRPC_PYTHON_BUILD_SYSTEM_OPENSSL=1 export GRPC_PYTHON_BUILD_SYSTEM_ZLIB=1 pip install grpcio # 👇️ if you use Anaconda conda install -c conda-forge grpcio

要解决该错误,请确保:

  1. 您没有过时版本的pipsetuptoolswheel
  2. 您的 Python 版本不超出 grpcio 支持的版本范围。

运行以下命令来升级pipsetuptoolswheel

pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel

更新后pipsetuptools运行wheel以下命令进行安装grpcio

pip install grpcio pip3 install grpcio python -m pip install grpcio python3 -m pip install grpcio # 👇️ for Anaconda conda install -c conda-forge grpcio

当您尝试安装的包不适合wheels您的 Python 版本时,有时会导致该错误。

您可以使用以下python --version命令检查您的 Python 版本。

python --version

您可以在包的 pypi 页面的下载文件部分检查包是否具有可用于特定 Python 版本的轮子。

例如,cp310“Built Distributions”下的文件名称表示特定操作系统支持 Python 版本 3.10。

如果这些.whl文件不适用于您的 Python 版本,您可以下载旧版本。

Python 中因 Pillow 错误而构建轮子失败

出现“枕头构建轮失败”错误的原因有多种:

  1. 拥有过时版本的pip,setuptoolswheel.
  2. 拥有不受Pillow.
  3. 安装了与Pillow模块冲突的软件包。
Failed building wheel for Pillow Running setup.py clean for Pillow Failed to build Pillow

首先,如果您使用的是 Debian (Ubuntu),请确保您已安装Pillow的所有要求

sudo apt-get install libjpeg-dev zlib1g-dev

要解决该错误,请确保:

  1. 您没有过时版本的pipsetuptoolswheel
  2. 您的 Python 版本不超出 Pillow 支持的版本范围。

运行以下命令来升级pipsetuptoolswheel

pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel

更新后pipsetuptools运行wheel以下命令进行安装Pillow

pip install Pillow pip3 install Pillow python -m pip install Pillow python3 -m pip install Pillow # 👇️ for Anaconda conda install -c anaconda pillow

当您尝试安装的包不适合wheels您的 Python 版本时,有时会导致该错误。

您可以使用以下python --version命令检查您的 Python 版本。

python --version

您可以在包的 pypi 页面的下载文件部分检查包是否具有可用于特定 Python 版本的轮子。

例如,cp310“Built Distributions”下的文件名称表示特定操作系统支持 Python 版本 3.10。

如果这些.whl文件不适用于您的 Python 版本,您可以下载旧版本。

Python 中 uwsgi 错误构建轮子失败

要解决“uwsgi 构建轮失败”错误,请运行命令
pip install --upgrade pip来升级您的pip版本,安装先决条件并重新运行该pip install uWSGI命令。

Failed building wheel for uwsgi Running setup.py clean for uwsgi Failed to build uwsgi error: legacy-install-failure

首先,如果您使用的是 Linux,请确保安装gccpython3-dev

# 👇️ for Debian (Ubuntu) sudo apt-get install gcc python3-dev build-essential # 👇️ for RedHad / CentOS sudo yum install gcc python3-devel # 👇️ for Alpine Linux apk add gcc libc-dev

运行以下命令来升级pipsetuptoolswheel

pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel

更新后pipsetuptools运行wheel以下命令进行安装uwsgi

pip install uWSGI pip3 install uWSGI python -m pip install uWSGI python3 -m pip install uWSGI # 👇️ for Anaconda conda install -c conda-forge uwsgi

在 Python 中构建 mysqlclient 的轮子失败

出现“Failed Building Wheel for mysqlclient”错误的原因有多种:

  1. 拥有过时版本的pip,setuptoolswheel.
  2. 拥有不受mysqlclient.
  3. 安装了与mysqlclient模块冲突的软件包。

mysqlclient 构建轮子失败错误

Failed building wheel for mysqlclient Running setup.py clean for mysqlclient Failed to build mysqlclient error: legacy-install-failure

首先,如果您使用macOSLinux,请安装先决条件。

# 👇️ for macOS brew install mysql pip install mysqlclient # 👇️ for Debian/Ubuntu sudo apt-get install python3-dev default-libmysqlclient-dev build-essential pip install mysqlclient # 👇️ for Red Hat/CentOS sudo yum install python3-devel mysql-devel pip install mysqlclient # 👇️ for Anaconda conda install -c conda-forge mysqlclient # 👇️ for Jupyter Notebook !pip install mysqlclient

mysqlclient模块是未维护的软件包的一个分支MySQL-python,并添加了对 Python 3 的支持。

要解决该错误,请确保:

  1. 您没有过时版本的pipsetuptoolswheel
  2. 您的 Python 版本不超出mysqlclient.

运行以下命令来升级pipsetuptoolswheel

pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel

更新后pipsetuptools运行wheel以下命令进行安装mysqlclient

pip install mysqlclient pip3 install mysqlclient python -m pip install mysqlclient python3 -m pip install mysqlclient # 👇️ for Anaconda conda install -c conda-forge mysqlclient

当您尝试安装的包不适合wheels您的 Python 版本时,有时会导致该错误。

您可以使用以下python --version命令检查您的 Python 版本。

python --version

您可以在包的 pypi 页面的下载文件部分检查包是否具有可用于特定 Python 版本的轮子。

例如,cp310“Built Distributions”下的文件名称表示特定操作系统支持 Python 版本 3.10。

如果这些.whl文件不适用于您的 Python 版本,您可以下载旧版本。

如果错误仍然存​​在,请按照我的
ModuleNotFoundError:没有名为“ConfigParser”的模块
一文中的说明进行操作。

在 Python 中构建 wordcloud 轮子失败

出现“wordcloud 构建轮失败”错误的原因有多种:

  1. 拥有过时版本的pip,setuptoolswheel.
  2. 拥有不受wordcloud.
  3. 安装了与wordcloud模块冲突的软件包。

wordcloud 的构建轮子错误失败

Failed building wheel for wordcloud Running setup.py clean for wordcloud Failed to build wordcloud error: legacy-install-failure

要解决该错误,请确保:

  1. 您没有过时版本的pipsetuptoolswheel
  2. 您的 Python 版本不超出wordcloud.

运行以下命令来升级pipsetuptoolswheel

pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel

更新后pipsetuptools运行wheel以下命令安装wordcloud

pip install wordcloud pip3 install wordcloud python -m pip install wordcloud python3 -m pip install wordcloud # 👇️ for Anaconda conda install -c conda-forge wordcloud

如果您使用的是 Windows,您还可以.whl
https://www.lfd.uci.edu/~gohlke/pythonlibs/
网站下载合适的文件。

首先,获取您的 Python 版本并检查您的
Python 安装是 64 位还是 32 位

您可以通过打开 CMD 并输入 来完成此操作python

获取 python 版本和位

例如,屏幕截图显示我的Python版本是3.10,我的Python解释器是64位。

现在,单击
https://www.lfd.uci.edu/~gohlke/pythonlibs/
链接,按
CTRL + f并搜索wordcloud或单击
以下链接

下载对应的.whl文件。例如,我会下载以下文件。

wordcloud‑1.8.1‑cp310‑cp310‑win_amd64.whl
cp310部分是版本(Python 3.10),表示 64 位。 amd64

打开文件后,在文件所在目录(例如C:\Users\Example\Downloads)中打开 shell 并使用以下命令安装它pip

  1. 在资源管理器中打开包含该文件的目录。
  2. 在资源管理器中按下Shift并右键单击。

windows 在此处打开 powershell 窗口

  1. 单击“在此处打开 PowerShell 窗口”。
  2. 运行以下命令。
pip install wordcloud‑1.8.1‑cp310‑cp310‑win_amd64.whl pip3 install wordcloud‑1.8.1‑cp310‑cp310‑win_amd64.whl

确保正确指定文件名,.whl因为您的 Python 版本可能会有所不同。

在 Python 中为 llvmlite 构建轮子失败

出现“llvmlite 构建轮失败”错误的原因有多种:

  1. 拥有过时版本的pip,setuptoolswheel.
  2. 拥有不受llvmlite.
  3. 安装了与llvmlite模块冲突的软件包。
Failed building wheel for llvmlite Running setup.py clean for llvmlite Failed to build llvmlite

运行以下命令来升级pipsetuptoolswheel

pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel

要解决该错误,请确保:

  1. 您没有过时版本的pipsetuptoolswheel
  2. 您的 Python 版本不超出llvmlite.

如果您尝试安装
numba ,本文中的解决方案也适用。

更新后pipsetuptools运行wheel以下命令进行安装llvmlite

pip install llvmlite pip3 install llvmlite python -m pip install llvmlite python3 -m pip install llvmlite # 👇️ for Anaconda conda install -c conda-forge llvmlite

如果您使用的是 Windows,您还可以.whl
https://www.lfd.uci.edu/~gohlke/pythonlibs/
网站下载合适的文件。

首先,获取您的 Python 版本并检查您安装的 Python 是 64 位还是 32 位。

您可以通过打开 CMD 并输入 来完成此操作python

获取 python 版本和位

例如,屏幕截图显示我的Python版本是3.10,我的Python解释器是64位。

现在,单击
https://www.lfd.uci.edu/~gohlke/pythonlibs/
链接,按
CTRL + f并搜索llvmlite或单击
以下链接

下载对应的.whl文件。例如,我会下载以下文件。

llvmlite‑0.38.1‑cp310‑cp310‑win_amd64.whl
cp310部分是版本(Python 3.10),表示 64 位。 amd64

打开文件后,在文件所在目录(例如C:\Users\Example\Downloads)中打开 shell 并使用以下命令安装它pip

  1. 在资源管理器中打开包含该文件的目录。
  2. 在资源管理器中按下Shift并右键单击。

windows 在此处打开 powershell 窗口

  1. 单击“在此处打开 PowerShell 窗口”。
  2. 运行以下命令。
pip install llvmlite‑0.38.1‑cp310‑cp310‑win_amd64.whl pip3 install llvmlite‑0.38.1‑cp310‑cp310‑win_amd64.whl

确保正确指定文件名,.whl因为您的 Python 版本可能会有所不同。

如果您尝试安装该numba软件包,可以从以下链接.whl下载其
文件
并重复这些步骤。

在 Python 中构建 torch (PyTorch) 轮子失败

出现“火炬构建轮失败”错误的原因有多种:

  1. 拥有过时版本的pip,setuptoolswheel.
  2. 拥有不受torch.
  3. 安装了与torch模块冲突的软件包。
Failed building wheel for torch Running setup.py clean for torch Failed to build torch

运行以下命令来升级pipsetuptoolswheel

pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel

要解决该错误,请确保:

  1. 您没有过时版本的pipsetuptoolswheel
  2. 您的 Python 版本不超出torch.

更新后pipsetuptools运行wheel以下命令进行安装torch

pip install torch pip3 install torch python -m pip install torch python3 -m pip install torch # 👇️ for Anaconda conda install -c pytorch pytorch

您还可以尝试从
官方文档构建合适的安装命令。

单击链接,选择您的操作系统和环境,然后从“运行此命令”部分复制命令。

当您尝试安装的包不适合wheels您的 Python 版本时,有时会导致该错误。

您可以使用以下python --version命令检查您的 Python 版本。

python --version

您可以在包的 pypi 页面的下载文件部分检查包是否具有可用于特定 Python 版本的轮子。

例如,cp310“Built Distributions”下的文件名称表示特定操作系统支持 Python 版本 3.10。

如果这些.whl文件不适用于您的 Python 版本,您可以下载旧版本。