默认安装 pydantic v2，因当前主干版本为 v2 且要求 python ≥3.10；若环境为 python 3.8–3.9，需显式指定 pip install "pydantic

pip install pydantic 会装哪个版本

默认执行 pip install pydantic 安装的是 Pydantic V2（即当前主干版本），不是已停止维护的 V1。V2 要求 Python 3.10+，低于该版本会报错并拒绝安装——这不是 pip 的警告，而是 pyproject.toml 中 requires-python = '>=3.10' 的硬性约束。

常见错误现象：ERROR: Package 'pydantic' requires a different Python version，说明环境是 Python 3.9 或更低。

• 如果必须用 Python 3.8/3.9，只能退回到 V1：pip install "pydantic（但不推荐，V1 已归档，无安全更新）
• V2 默认不带 .env 支持，读取环境变量需额外依赖
• 安装后验证：运行 python -c "import pydantic; print(pydantic.__version__)"，输出应为 2.x.x

要不要加 -U 参数

pip install -U pydantic 仅在你已有旧版（比如 V1）且想强制升级时才需要；若首次安装或确认本地无 pydantic，-U 多余，还可能意外触发其他依赖的升级，引发兼容问题。

更稳妥的做法是显式指定版本号：

Bytesagain Ci Cd Pipeline

生成 GitHub Actions、GitLab CI、Jenkins 的 CI/CD 流水线配置，适用于 Node.js、Python、Go、Docker 项目，支持回滚等配置。

下载

• 装最新稳定版：pip install pydantic
• 锁死小版本（防破坏性更新）：pip install "pydantic~=2.9.0"
• 装预发布版（如测试新特性）：pip install --pre pydantic

pydantic-settings 怎么一起装

Pydantic V2 把配置管理（.env 文件、环境变量加载等）拆到了独立包 pydantic-settings，它和 pydantic 不自动联动。

如果你要用 BaseSettings 或 SettingsConfigDict 加载 .env，必须单独装：

• 基础安装：pip install pydantic-settings（会自动拉取 pydantic 和 python-dotenv）
• 如果已装过 pydantic，再执行上条命令，不会重复安装，只补依赖
• 别用 pip install pydantic[dotenv] —— 这是 V1 的写法，V2 不识别该 extra

国内镜像源怎么配才有效

直接在命令里加 -i 参数最简单，阿里云源目前稳定：

pip install -i https://mirrors.aliyun.com/pypi/simple/ pydantic

注意两点：

• URL 末尾的 / 不能省，否则 pip 可能忽略镜像
• 如果公司内网有私有源，优先用 --index-url 而非 -i，避免被 pip.conf 中的全局 index 覆盖
• conda 用户不要混用：conda install pydantic -c conda-forge 和 pip 安装的 pydantic 可能冲突，尤其涉及 rust 编译部分

V2 的核心变化在于模块拆分和类型系统重构，pydantic-settings 不是可选插件，而是配置场景的必需依赖——这点容易被忽略，直到 from pydantic_settings import BaseSettings 报错才意识到装错了包。