默认安装 Pydantic v2，因当前主干版本为 v2 且要求 Python ≥3.10；若环境为 Python 3.8–3.9，需显式指定 pip install "pydantic<2.0.0" 安装 v1。
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 编译部分
pydantic-settings 不是可选插件，而是配置场景的必需依赖——这点容易被忽略，直到 from pydantic_settings import BaseSettings 报错才意识到装错了包。 
