pip安装中“ X的构建车轮失败”是什么意思？

112

在SO上，这是一个真正流行的问题，但是我看过的所有答案中，没有一个能清楚地说明此错误的真正含义以及发生的原因。

造成混乱的原因之一是，当您（例如）这样做时pip install pycparser，您首先会得到以下错误：

Failed building wheel for pycparser

然后出现以下消息，说明该软件包是：

Successfully installed pycparser-2.19。

# pip3 install pycparser

Collecting pycparser
  Using cached https://files.pythonhosted.org/packages/68/9e/49196946aee219aead1290e00d1e7fdeab8567783e83e1b9ab5585e6206a/pycparser-2.19.tar.gz
Building wheels for collected packages: pycparser
  Running setup.py bdist_wheel for pycparser ... error
  Complete output from command /usr/bin/python3 -u -c "import setuptools, tokenize;__file__='/tmp/pip-install-g_v28hpp/pycparser/setup.py';f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, __file__, 'exec'))" bdist_wheel -d /tmp/pip-wheel-__w_f6p0 --python-tag cp36:
  Traceback (most recent call last):
    File "<string>", line 1, in <module>
    ...
    File "/usr/lib/python3.6/site-packages/pkg_resources/__init__.py", line 2349, in resolve
      module = __import__(self.module_name, fromlist=['__name__'], level=0)
  ModuleNotFoundError: No module named 'wheel.bdist_wheel'

  ----------------------------------------
  Failed building wheel for pycparser
  Running setup.py clean for pycparser
Failed to build pycparser
Installing collected packages: pycparser
  Running setup.py install for pycparser ... done
Successfully installed pycparser-2.19

这里发生了什么？

（我想了解如何发生某些故障但仍然可以安装，以及是否可以信任此软件包正常运行？）

到目前为止，我已经找到了最好的部分原因是这个。

python  python-3.x  pip  python-wheel 
— not2qubit
source
8
当pip找不到所需的车轮时，它将下载源dist并尝试从本地构建一个车轮。成功完成后，轮子将存储在pip的缓存中，以供将来重新安装。如果车轮制造失败，请pip从源dist（调用python setup.py install）切换到旧版安装。
— 霍夫林
在您的情况下，您缺少该wheel软件包，因此pip无法从源dists构建轮子。如果要显式禁用建筑轮子，请使用--no-binary标志：pip install somepkg --no-binary=somepkg。或使用pip install somepkg --no-binary=:all:，但要注意，这将禁用所有安装选择的软件包的轮子，包括依赖项；如果没有源dist可用于某些软件包的pip安装，则安装将失败。
— 霍夫林
2
@hoefling：您的第一个评论是真正的原因，并且可能是答案。第二个错误：--no-binary指示pip仅下载和使用源代码发行版。阻止它建立本地二进制轮的标志确实是--no-cache-dir。
— Serge Ballesta，
@hoefling我有wheels（0.32.2），所以这不是问题。但是，也许pycparser包装中没有*.whl关联的转轮（）？但是，如何检查此先验？
— not2qubit
1
您可以访问pypi.org/project/pycparser的PyPI网站，然后索取文件。然后，您会看到只有一个.tar.gz文件存在，并且是PyPI上的源分发（一个轮子会带有.whl扩展名）
— Serge Ballesta

Answers:

93

（这里是点子维护者！）

如果包装不是车轮，则pip尝试为其构建一个车轮（通过setup.py bdist_wheel）。如果由于任何原因导致安装失败，您将收到“ pycparser的建筑轮子故障”消息，并且pip退回到直接安装（通过setup.py install）。

装好轮子后，pip可以通过正确打开包装来安装轮子。pip尝试尽可能多地通过轮子安装软件包。这是由于使用滚轮的各种优势（例如更快的安装，可缓存的，不再执行代码等）。

您在这里的错误消息是由于wheel缺少软件包，其中包含构建轮子所需的逻辑setup.py bdist_wheel。（pip install wheel可以解决该问题。）

以上是当前默认的旧行为；我们会默认在将来的某个时间切换到PEP 517，为此我们将转到基于标准的流程。我们还为此提供了隔离的版本，因此，默认情况下，您会在这些环境中安装滚轮。:)

— 普拉贡斯
source
1
在编写OP时，我已经wheel安装了该软件包。另外，请添加指向PEP517的链接。
— not2qubit
您是否安装了旧版的setuptools或wheel？如果没有，那似乎是那里失败的原因。无论如何，从pip的POV角度来看，它无法构建轮子，因此可以正常安装。
— pradyunsg
48

昨天，我遇到了同样的错误： Failed building wheel for hddfancontrol跑步时pip3 install hddfancontrol。结果是Failed to build hddfancontrol。原因是error: invalid command 'bdist_wheel'和Running setup.py bdist_wheel for hddfancontrol ... error。通过运行以下命令修复了该错误：

 pip3 install wheel

（从这里开始。）

另外，也可以从此处直接下载“ wheel” 。下载后，可以通过运行以下命令进行安装：

pip3 install "/the/file_path/to/wheel-0.32.3-py2.py3-none-any.whl"
— 马修·韦
source
pip3 install wheel效果很好，甚至在“ python3 -m venv”内部也是如此，直到今天，我还是venv的新手
— Manohar Reddy Poreddy
1
即使安装轮子后，它对我也不起作用！
— vatsalay
31

从那以后，似乎没有人提到我自己。我自己解决上述问题是最常见的，以确保禁用缓存使用副本：pip install <package> --no-cache-dir。

— not2qubit
source
1
如果您只是希望摆脱此错误，那么这可以算是解决方法，否则，我将其称为解决方法。
— 尼尔斯·马格努斯
@NilsMagnus这是不是只是getting rid of the message，它允许安装继续进行，即使安装程序认为它已经更新，由于以前经常以失败告终更新含有残留缓存目录。
— not2qubit
^^也就是说，我一直在想为什么这不是默认行为？谁在更新时想保留缓存的副本？只是没有任何意义。
— not2qubit
4
问题的公认答案如何？它没有回答问题。
— PascalIv
1
因为他本人也要问并回答。我认为这样他可以接受我相信的答案。听起来很奇怪，但事实可能如此。
— 阿米特·阿莫拉
4

从程序包部署的角度解决此问题可能会有所帮助。

那里有许多教程介绍了如何将程序包发布到PyPi。以下是我使用过的几对；

中型
真正的python

我的经验是，这些教程大多数都只使用源代码的.tar，而不使用转盘。因此，在安装使用这些教程创建的软件包时，我收到了“无法构建轮子”错误。

后来我在PyPi上找到了指向Python软件基金会的文档PSF Docs的链接。我发现它们的设置和构建过程略有不同，并且确实包括构建wheel文件。

使用正式记录的方法后，安装软件包时不再收到错误。

因此，错误可能只是开发人员如何打包和部署项目的问题。我们当中没有一个人天生就知道如何使用PyPi，如果它们是在错误的教程上发生的，那么您可以填补空白。

我敢肯定这不是错误的唯一原因，但我敢打赌这是主要原因。

— 史蒂夫·J
source
2

试试这个：

sudo apt-get install libpcap-dev libpq-dev

当我安装了这两个时，它对我有用。

有关更多信息，请参见此处的链接。

— tw
source
0

在Ubuntu 18.04上，我遇到了此问题，因为的apt软件包wheel不包含wheel命令。我认为pip尝试导入wheelpython包，如果成功，则假定wheel命令也可用。Ubuntu打破了这一假设。

apt python3代码包的名称为python3-wheel。这是自动安装的，因为python3-pip建议您这样做。

apt python3 wheel命令包的名称为python-wheel-common。安装此工具也可以为我解决“建筑轮子故障”错误。

— 简·凯尼斯
source
— JanKanis
0

当我尝试安装pip install django-imagekit时，出现了相同的消息。因此，我运行了pip install wheel（我安装了python 2.7），然后重新运行了pip install django-imagekit，它开始工作了。谢谢

— 马克·古文克（Marc Guvenc）
source
0

我想补充一点，如果您的系统上只有Python3，则需要开始使用pip3而不是pip。

您可以使用以下命令安装pip3；

sudo apt install python3-pip -y

之后，您可以尝试安装所需的软件包。

sudo pip3 install <package>
— 马腾
source
0

错误：

系统：AWS EC2实例（T2小）

问题：通过安装opencv python时

pip3 install opencv-python

  Problem with the CMake installation, aborting build. CMake executable is cmake
  
  ----------------------------------------
  Failed building wheel for opencv-python
  Running setup.py clean for opencv-python

什么对我有用

pip3 install --upgrade pip setuptools wheel

在此之后，您仍然可能会收到休闲错误错误

    from .cv2 import *
ImportError: libGL.so.1: cannot open shared object file: No such file or directory

安装libgl为我解决了错误。

sudo apt update
sudo apt install libgl1-mesa-glx

希望这可以帮助

— 赫曼特
source
0

安装Brotli时遇到相同的问题

错误

Failed building wheel for Brotli

我通过.whl从此处下载文件 并使用以下命令进行安装来解决了该问题

C:\Users\{user_name}\Downloads>pip install Brotli-1.0.9-cp39-cp39-win_amd64.whl
— 塔林达·卡拉维塔（Tharinda karawita）
source
-1

这可能对您有帮助！....

卸载pycparser：

pip uninstall pycparser

重新安装pycparser：

pip install pycparser

我在安装termcolor时遇到了同样的错误，并通过重新安装进行了修复。

— 绝对的智慧
source
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.