# 错误：<package>.whl 不是此平台支持的 wheel。它与当前 Python 解释器或平台不兼容。

- **ID:** `pip/wheel-manylinux-incompatible`
- **领域:** pip
- **类别:** install_error
- **错误码:** `ERROR`
- **验证级别:** ai_generated
- **修复率:** 92%

## 根因

wheel 文件的平台标签（例如 manylinux2014_x86_64）与用户系统架构或 Python 版本不匹配，通常是因为下载了针对不同操作系统或 Python ABI 的 wheel。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| pip 21.0 | active | — | — |
| pip 23.0 | active | — | — |
| pip 24.0 | active | — | — |

## 解决方案

1. ```
   改为安装源码发行版：`pip install <package> --no-binary :all:`
   ```
2. ```
   下载适合你平台的 wheel：检查 Python 版本（`python3 -c 'import sys; print(sys.version)'`）和架构（`uname -m`），然后在 https://pypi.org/project/<package>/#files 找到兼容的 wheel
   ```
3. ```
   使用 `--platform` 和 `--python-version` 标志进行交叉编译：`pip install <package> --platform manylinux2014_x86_64 --python-version 3.10 --implementation cp --abi cp310`
   ```

## 无效尝试

- **Re-download the same wheel file from PyPI manually.** — The wheel file itself is correct; the issue is platform incompatibility, not file corruption. (95% 失败率)
- **Use --no-index and point to a local wheelhouse without checking tags.** — pip still validates platform tags even with --no-index; this flag only skips index lookup. (80% 失败率)
- **Force install with --force-reinstall ignoring warnings.** — pip will abort with an error; --force-reinstall does not bypass platform tag checks. (100% 失败率)