python install_error ai_generated true

error: invalid command 'bdist_wheel'

ID: python/setuptools-command-not-found-bdist-wheel

Also available as: JSON · Markdown · 中文
80%Fix Rate
90%Confidence
0Evidence
2024-02-22First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
3.8 active — — —
3.9 active — — —
3.10 active — — —
3.11 active — — —
3.12 active — — —

Root Cause

The wheel package is not installed, so setuptools cannot find the bdist_wheel command. Modern build frontends (pip, build) install this automatically, but direct `python setup.py bdist_wheel` calls do not.

generic

中文

wheel 包未安装，因此 setuptools 找不到 bdist_wheel 命令。现代构建前端（pip、build）会自动安装它，但直接调用 `python setup.py bdist_wheel` 不会。

Workarounds

  1. 97% success 
    pip install wheel && python setup.py bdist_wheel
  2. 98% success 
    pip install build && python -m build

Dead Ends

Common approaches that don't work:

  1. 60% fail

    Deprecated and bypasses wheel building; produces a non-portable install.

  2. 90% fail

    setuptools does not bundle wheel; the wheel package must be installed separately.