python - pip install中 "Failed building wheel for X"是什么意思？

Question

这是 SO 上一个非常受欢迎的问题，但我看过的许多答案都没有清楚地解释这个错误的真正含义以及它发生的原因。

混淆的一个来源是，当(例如)你执行 pip install pycparser 时，你首先会得到错误:

pycparser 构建轮子失败

然后是包裹的消息:

成功安装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

这是怎么回事？

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

到目前为止，我找到的最好的部分解释是 this .

Answer 1

(这里是 pip 维护者!)

快速复制粘贴:

pip install wheel

在使用 venv 创建的每个新虚拟环境中执行此操作。

继续阅读以了解详细信息和说明。

---

如果包不是轮子，pip 会尝试为它构建一个轮子(通过 setup.py bdist_wheel)。如果由于任何原因失败(例如，缺少系统级库、与您的系统不兼容、构建轮中的版本字符串错误等)，您会收到“{...} 构建轮失败”消息。

在某些情况下，目前，pip 回退到通过 setup.py install 安装，因此安装仍有可能成功。也就是说，pip 总是尽可能多地尝试通过轮子安装包。这是因为使用轮子的各种优 pip (如更快的安装、可缓存、不再执行代码等)以及它是一种标准化格式的事实；与(已弃用的)setup.py 安装界面不同。

---

您的错误消息是由于缺少 wheel 包，该包包含在 setup.py bdist_wheel 中构建轮子所需的逻辑。 (pip install wheel 可以解决这个问题——但由于系统配置，它不会解决任何构建时间问题)

---

在未来的某个时候，我们将默认切换到更现代的构建系统(如果您是包作者，您可以通过添加 pyproject.toml 来选择加入)通过安装轮子的隔离构建环境解决此问题。 :)

• PEP 517:A build-system independent format for source trees
• 关于“PEP 517 and 518 in Plain English”的博文