# ImportError: 未安装 email-validator，请运行 `pip install pydantic[email]`

- **ID:** `python/fastapi-attribute-error-email-validator`
- **领域:** python
- **类别:** install_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

Pydantic 模型使用了 `EmailStr`，它依赖可选的 `email-validator` 包。

## 版本兼容性

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

## 解决方案

1. **** (98% 成功率)
   ```
   pip install 'pydantic[email]'
   ```
2. **** (97% 成功率)
   ```
   echo 'pydantic[email]' >> requirements.txt && pip install -r requirements.txt
   ```

## 无效尝试

- **** — Loses email validation; invalid emails pass through to the DB. (70% 失败率)
- **** — Wrong package name; installs an unrelated module. (95% 失败率)
