python install_error ai_generated true

ERROR: foo-1.2.0-cp311-cp311-manylinux_2_17_x86_64.whl is not a supported wheel on this platform.

ID: python/pip-wheel-not-supported-on-platform

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

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
3.x active — — —

Root Cause

The wheel's platform/ABI tag (cp311 manylinux x86_64) does not match the current interpreter or architecture (e.g. macOS arm64, or Python 3.10). pip rejects the incompatible wheel.

generic

中文

wheel 的平台/ABI 标签（cp311 manylinux x86_64）与当前解释器或架构不匹配（如 macOS arm64 或 Python 3.10）。pip 拒绝不兼容的 wheel。

Workarounds

  1. 90% success 
    Let pip pick the right wheel: pip install foo  # pip selects the correct tag for your platform/Python
  2. 82% success 
    Check supported tags: python -m pip debug --verbose | grep -A20 'Compatible tags'  # then download a wheel matching one of them

Dead Ends

Common approaches that don't work:

  1. 85% fail

    Force-reinstall doesn't bypass the platform tag check; pip still refuses the incompatible wheel.

  2. 80% fail

    Ignore-installed only skips the uninstall step; platform compatibility is still enforced.