# 错误：找不到满足需求 <package>==1.2.3 的版本（可用版本：无）
错误：找不到匹配的发行版 <package>==1.2.3

- **ID:** `python/pip-no-matching-distribution-platform`
- **领域:** python
- **类别:** install_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

精确版本不存在于当前平台/Python 组合，或包名拼写错误，或私有索引配置错误（--index-url 不对）。

## 版本兼容性

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

## 解决方案

1. **** (85% 成功率)
   ```
   pip index versions <package>
pip debug --verbose  # shows compatible tags
   ```
2. **** (80% 成功率)
   ```
   pip config list
pip install --index-url https://pypi.org/simple <package>==1.2.3
   ```

## 无效尝试

- **** — Upgrading pip won't create a distribution that doesn't exist for your platform. (85% 失败率)
- **** — --no-index disables PyPI entirely, guaranteeing failure unless a local wheel is present. (95% 失败率)