# 错误：foo-1.2.0-cp311-cp311-manylinux_2_17_x86_64.whl 在此平台上不受支持。

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

## 根因

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

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.x | active | — | — |

## 解决方案

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

## 无效尝试

- **** — Force-reinstall doesn't bypass the platform tag check; pip still refuses the incompatible wheel. (85% 失败率)
- **** — Ignore-installed only skips the uninstall step; platform compatibility is still enforced. (80% 失败率)