# 错误：找不到满足 hatchling 要求的版本（可用版本：无）
错误：未找到匹配 hatchling 的发行版

- **ID:** `python/pip-install-requires-build-backend-missing`
- **领域:** python
- **类别:** install_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

包的 pyproject.toml 声明了构建后端（如 hatchling），但配置的索引（通常是私有镜像）中不存在该后端。

## 版本兼容性

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

## 解决方案

1. **** (90% 成功率)
   ```
   Add PyPI as a secondary index: `pip install --extra-index-url https://pypi.org/simple <pkg>`.
   ```
2. **** (88% 成功率)
   ```
   Pre-install the build backend and disable isolation: `pip install hatchling && pip install --no-build-isolation <pkg>`.
   ```

## 无效尝试

- **** — Uses the current env's build backend; if hatchling is not installed there either, the same error appears. (70% 失败率)
- **** — pip cannot conjure a package the index does not serve. (90% 失败率)