# ModuleNotFoundError: 没有名为 'uvloop' 的模块

- **ID:** `python/uvloop-import-error`
- **领域:** python
- **类别:** module_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

当前环境中未安装 uvloop，或它安装在运行应用所用解释器之外的其他 Python 中（在 venv 与多版本环境中常见）。

## 版本兼容性

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

## 解决方案

1. **** (92% 成功率)
   ```
   python -c 'import sys; print(sys.executable)'
python -m pip install uvloop
python -c 'import uvloop; print(uvloop.__version__)'
   ```
2. **** (90% 成功率)
   ```
   try:
    import uvloop
    uvloop.install()
except ImportError:
    pass  # use default asyncio loop
   ```

## 无效尝试

- **** — Installs into the system Python, not the venv, so the app still cannot import it. (80% 失败率)
- **** — Mixes incompatible ABI builds and typically produces ImportError on the C extension. (85% 失败率)