python data_error ai_generated true

ERROR: Invalid wheel filename: 'my_pkg-1.0-py3-none-any.whl' - wheel filenames must have the form: {distribution}-{version}(-{build tag})?-{python tag}-{abi tag}-{platform tag}.whl

ID: python/pip-wheel-filename-invalid

Also available as: JSON · Markdown · 中文
80%Fix Rate
85%Confidence
0Evidence
2025-05-20First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
3.10 active — — —

Root Cause

The wheel filename does not follow the PEP 427 naming convention, often due to missing tags or incorrect separators.

generic

中文

wheel文件名不符合PEP 427命名约定，通常由于标签缺失或分隔符错误。

Workarounds

  1. 90% success 
    python setup.py bdist_wheel
  2. 80% success 
    mv my_pkg-1.0-py3-none-any.whl my_pkg-1.0-py3-none-any.whl (ensure underscores and hyphens correct)
  3. 85% success 
    pip wheel . --no-deps

Dead Ends

Common approaches that don't work:

  1. 70% fail

    May still not meet the spec.

  2. 100% fail

    Pip refuses to install.

  3. 90% fail

    Must be .whl.