# pydantic.errors.PydanticUserError：`EmailStr` 需要 `email-validator` 包。请使用 `pip install pydantic[email]` 安装。

- **ID:** `python/pydantic-email-str-deprecated`
- **领域:** python
- **类别:** install_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

使用了 EmailStr，但未安装可选的 email-validator 依赖。

## 版本兼容性

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

## 解决方案

1. **** (98% 成功率)
   ```
   pip install 'pydantic[email]'
   ```
2. **** (97% 成功率)
   ```
   pip install email-validator
# then
from pydantic import BaseModel, EmailStr
class U(BaseModel):
    email: EmailStr
   ```

## 无效尝试

- **** — Wrong package; 'email' is a stdlib module, not a PyPI validator. (70% 失败率)
- **** — Loses email format validation; invalid addresses pass through. (55% 失败率)
- **** — Import still fails until the interpreter restarts. (40% 失败率)