# ImportError: uvloop 需要 Python 3.8 或更高版本

- **ID:** `python/uvicorn-loop-uvloop-install-failed`
- **领域:** python
- **类别:** install_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

当前 Python 版本或平台缺少 uvloop wheel，或正在导入陈旧的 uvloop 构建。

## 版本兼容性

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

## 解决方案

1. **** (95% 成功率)
   ```
   uvicorn app:app --loop asyncio
   ```
2. **** (85% 成功率)
   ```
   python -c 'import sys; print(sys.version)'
pip install --only-binary=:all: 'uvloop>=0.19'
   ```

## 无效尝试

- **** — May install a wheel built for a different Python ABI; import still fails. (60% 失败率)
- **** — Auto still prefers uvloop on Linux when installed; the import error persists. (70% 失败率)