# 错误：foo-1.2.3-cp311-cp311-win_amd64.whl 不是此平台支持的 wheel。

- **ID:** `python/pip-wheel-not-supported-on-this-platform`
- **领域:** python
- **类别:** install_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

wheel 的平台/ABI 标签与当前解释器不匹配（例如在 Linux 上使用 Windows wheel，或在 cp310 上使用 cp311 wheel）。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.9 | active | — | — |
| 3.10 | active | — | — |
| 3.11 | active | — | — |
| 3.12 | active | — | — |

## 解决方案

1. **** (95% 成功率)
   ```
   Download the wheel matching your platform:
  pip download --only-binary=:all: --platform manylinux2014_x86_64 --python-version 311 --abi cp311 foo
Or simply: pip install foo (pip picks the right wheel).
   ```
2. **** (70% 成功率)
   ```
   Build from source if no matching wheel exists:
  pip install --no-binary=:all: foo
(requires a compiler toolchain).
   ```

## 无效尝试

- **** — Force-reinstall does not change the platform compatibility check. (95% 失败率)
- **** — Renaming breaks the internal RECORD and the wheel may still contain native code for the wrong platform. (90% 失败率)