python install_error ai_generated true

ERROR: foo-2.0.0-cp312-cp312-manylinux_2_17_x86_64.whl is not a supported wheel on this platform.

ID: python/pip-python-version-mismatch-wheel-tag

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

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
3.10 active — — —
3.11 active — — —

Root Cause

Wheel's ABI tag (cp312) doesn't match the running interpreter or platform.

generic

中文

wheel 的 ABI 标签（cp312）与运行的解释器或平台不匹配。

Workarounds

  1. 90% success 
    pip install foo  # let pip pick the right wheel
# or: pip install --no-binary :all: foo
  2. 85% success 
    pyenv install 3.12.4 && pyenv local 3.12.4
pip install foo

Dead Ends

Common approaches that don't work:

  1. 85% fail

    The binary is compiled for a different ABI; import crashes with undefined symbols.

  2. 80% fail

    Force does not bypass platform compatibility checks.