# ImportError: 没有名为 'uvicorn' 的模块

- **ID:** `python/starlette-importerror-uvicorn`
- **领域:** python
- **类别:** module_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

当前 Python 环境中未安装 Uvicorn ASGI 服务器。

## 版本兼容性

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

## 解决方案

1. **Install uvicorn using pip** (95% 成功率)
   ```
   pip install uvicorn
# Or for production: pip install 'uvicorn[standard]'
   ```
2. **Activate correct virtual environment** (90% 成功率)
   ```
   source venv/bin/activate  # Linux/Mac
venv\Scripts\activate  # Windows
pip install uvicorn
   ```

## 无效尝试

- **Installing in wrong virtual environment** — Package installed but not in active env. (80% 失败率)
- **Using pip without --user flag in system Python** — May not have permissions; use virtualenv. (60% 失败率)