目录
Failed building wheel for X when using pip install [Solved]
- 使用 pip install 时 X 的构建轮失败
- psycopg2 构建轮子失败
- h5py 构建轮子失败
- grpcio 构建轮子失败
- 枕头组装轮失败
- uwsgi 构建轮子失败
- mysqlclient 构建轮子失败
- wordcloud 构建轮子失败
- llvmlite 构建轮子失败
- 火炬的造轮失败
使用 pip install 时 X 构建轮子失败
出现“X 构建轮失败”错误的原因有多种:
wheel
环境中没有安装该软件包。- 安装的软件包与我们尝试安装的软件包发生冲突。
- 我们尝试安装的软件包不支持 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
以下是在所有操作系统上进行升级的命令。
# 👇️ 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
仅查找稳定版本。
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
软件包后,该错误将得到解决。
如果错误未解决,请尝试安装带有
--no-cache-dir
禁用缓存选项的软件包。
pip install <package-name> --no-cache-dir pip3 install <package-name> --no-cache-dir
创建虚拟环境
如果这没有帮助,请尝试创建虚拟环境。
- 创建虚拟环境。
- 激活虚拟环境。
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 3.7+。
您还可以在包的 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 版本。
“寻找特定版本”表中提供了不同的版本
。
尝试在详细模式下运行 pip install
如果所有建议都没有帮助,请尝试pip install
在详细模式下运行该命令。
pip install requests -vvv pip3 install requests -vvv python -m pip install requests -vvv
该-v
选项代表详细模式,最多可以使用 3 次。
当该pip install
命令在详细模式下运行时,该命令会显示更多输出以及错误是如何发生的。
要解决“X 构建轮失败”错误,请确保:
- 您已
wheel
通过运行安装了该软件包pip install wheel
。 - 您没有任何与您尝试安装的软件包冲突的软件包。
- 该软件包支持您的 Python 版本。
以下是一些导致错误的包的示例
某些软件包要求您先安装某些先决条件,然后才能运行该pip install
命令。
以下是导致错误的最常见软件包。
目录
- psycopg2 构建轮子失败
- h5py 构建轮子失败
- grpcio 构建轮子失败
- 枕头组装轮失败
- uwsgi 构建轮子失败
- mysqlclient 构建轮子失败
- wordcloud 构建轮子失败
- llvmlite 构建轮子失败
- 火炬的造轮失败
Python 中因 psycopg2 错误而构建轮子失败
出现“psycopg2 构建轮失败”错误的原因有多种:
- 拥有过时版本的
pip
,setuptools
或wheel
. - 拥有不受
psycopg2-binary
. - 安装了与
psycopg2-binary
模块冲突的软件包。
Failed building wheel for psycopg2 Running setup.py clean for psycopg2 Failed to build psycopg2
要解决该错误,请确保:
- 您没有过时版本的
pip
、setuptools
或wheel
。 - 您的 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
运行以下命令来升级pip
、setuptools
和wheel
。
pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel
更新后pip
,setuptools
运行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 构建轮失败”错误的原因有多种:
- 拥有过时版本的
pip
,setuptools
或wheel
. - 拥有不受
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
要解决该错误,请确保:
- 您没有过时版本的
pip
、setuptools
或wheel
。 - 您的 Python 版本不超出
h5py
.
运行以下命令来升级pip
、setuptools
和wheel
。
pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel
更新后pip
,setuptools
运行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 构建轮失败”错误的原因有多种:
- 拥有过时版本的
pip
,setuptools
或wheel
. - 拥有不受
grpcio
. - 安装了与
grpcio
模块冲突的软件包。
Failed building wheel for grpcio Running setup.py clean for grpcio Failed to build grpcio
GRPC_PYTHON_BUILD_SYSTEM_OPENSSL
GRPC_PYTHON_BUILD_SYSTEM_ZLIB
1
true
grpcio
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
要解决该错误,请确保:
- 您没有过时版本的
pip
、setuptools
或wheel
。 - 您的 Python 版本不超出 grpcio 支持的版本范围。
运行以下命令来升级pip
、setuptools
和wheel
。
pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel
更新后pip
,setuptools
运行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 错误而构建轮子失败
出现“枕头构建轮失败”错误的原因有多种:
- 拥有过时版本的
pip
,setuptools
或wheel
. - 拥有不受
Pillow
. - 安装了与
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
要解决该错误,请确保:
- 您没有过时版本的
pip
、setuptools
或wheel
。 - 您的 Python 版本不超出 Pillow 支持的版本范围。
运行以下命令来升级pip
、setuptools
和wheel
。
pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel
更新后pip
,setuptools
运行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,请确保安装gcc
。python3-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
运行以下命令来升级pip
、setuptools
和wheel
。
pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel
更新后pip
,setuptools
运行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”错误的原因有多种:
- 拥有过时版本的
pip
,setuptools
或wheel
. - 拥有不受
mysqlclient
. - 安装了与
mysqlclient
模块冲突的软件包。
Failed building wheel for mysqlclient Running setup.py clean for mysqlclient Failed to build mysqlclient error: legacy-install-failure
首先,如果您使用macOS
或Linux
,请安装先决条件。
# 👇️ 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 的支持。
要解决该错误,请确保:
- 您没有过时版本的
pip
、setuptools
或wheel
。 - 您的 Python 版本不超出
mysqlclient
.
运行以下命令来升级pip
、setuptools
和wheel
。
pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel
更新后pip
,setuptools
运行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 构建轮失败”错误的原因有多种:
- 拥有过时版本的
pip
,setuptools
或wheel
. - 拥有不受
wordcloud
. - 安装了与
wordcloud
模块冲突的软件包。
Failed building wheel for wordcloud Running setup.py clean for wordcloud Failed to build wordcloud error: legacy-install-failure
要解决该错误,请确保:
- 您没有过时版本的
pip
、setuptools
或wheel
。 - 您的 Python 版本不超出
wordcloud
.
运行以下命令来升级pip
、setuptools
和wheel
。
pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel
更新后pip
,setuptools
运行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版本是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
:
- 在资源管理器中打开包含该文件的目录。
- 在资源管理器中按下
Shift
并右键单击。
- 单击“在此处打开 PowerShell 窗口”。
- 运行以下命令。
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 构建轮失败”错误的原因有多种:
- 拥有过时版本的
pip
,setuptools
或wheel
. - 拥有不受
llvmlite
. - 安装了与
llvmlite
模块冲突的软件包。
Failed building wheel for llvmlite Running setup.py clean for llvmlite Failed to build llvmlite
运行以下命令来升级pip
、setuptools
和wheel
。
pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel
要解决该错误,请确保:
- 您没有过时版本的
pip
、setuptools
或wheel
。 - 您的 Python 版本不超出
llvmlite
.
如果您尝试安装
numba ,本文中的解决方案也适用。
更新后pip
,setuptools
运行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版本是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
:
- 在资源管理器中打开包含该文件的目录。
- 在资源管理器中按下
Shift
并右键单击。
- 单击“在此处打开 PowerShell 窗口”。
- 运行以下命令。
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) 轮子失败
出现“火炬构建轮失败”错误的原因有多种:
- 拥有过时版本的
pip
,setuptools
或wheel
. - 拥有不受
torch
. - 安装了与
torch
模块冲突的软件包。
Failed building wheel for torch Running setup.py clean for torch Failed to build torch
运行以下命令来升级pip
、setuptools
和wheel
。
pip install --upgrade pip pip3 install --upgrade pip pip install --upgrade setuptools wheel pip3 install --upgrade setuptools wheel
要解决该错误,请确保:
- 您没有过时版本的
pip
、setuptools
或wheel
。 - 您的 Python 版本不超出
torch
.
更新后pip
,setuptools
运行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 版本,您可以下载旧版本。