进阶 pydantic.dev 2026-11-20 05:57:40 · 11 阅读

第11章 Pydantic 第11章:V3 后续计划与 V1/V2 支持策略

Pydantic Validation 自 2023 年 6 月发布 V2 以来已经走过了很长一段路。 经过 14 个小版本的迭代(最新为 V2.14),V2 变得更快、更正确,支持的 Python 类型系统范围也远超发布之初。 使用量也在同步增长。Pydantic 现已跻身 PyPI 下载量前 20 的包,月下载量超过 8 亿次。 我们已开始着手下一个大版本 Pydantic V3。以下是对未来的展望,以及对 V1 和 V2 的意义。

Pydantic V3: 🙂 not 😱

我们知道 V1 迁移到 V2 对部分用户来说很痛苦,这也是我们过去三年持续维护 V1 的原因。 V3 会有所不同。正如 tracking issue 中所述,所有破坏性变更都将属于以下两类之一:

正确性修复,例如只影响少数用户的 bug 修复(比如 #9992)。 可以轻松切换回旧行为的变更。

同时,V1 的弃用项和 pydantic.v1 命名空间也将被移除。 不会再出现 V1 迁移到 V2 那种规模的 API 大改。 这些年来我们积累了一份很长的 issue 清单,其中很多只有在 major release 中才能修复。 我们不会全部处理,但希望尽可能多地纳入 V3。 目前还没有发布日期,但我们的目标是让 V3 在今年年底接近最终形态。

Pydantic V1

我们已发布 Pydantic V1.10.27,这是 V1 的最后一个版本。该版本修复了一些安全问题,详见 changelog。 同样的修复也已包含在 Pydantic V2.14.2 随附的 pydantic.v1 命名空间中。

Pydantic V2

V3 发布后,V2 仍会继续获得重大 bug 和安全问题的修复。 维护时长取决于向 V3 迁移的顺利程度,因此我们暂未设定终止日期。 在确信大多数用户已迁移到 V3 之前,我们不会放弃 V2。

Enterprise support

Pydantic 本身保持开源,其 license、releases、文档和 issue tracker 依然对所有人开放。 但有些团队需要更多支持:你可能仍在生产环境使用 V1 而无法迁移,或者需要帮助规划向 V3 的迁移。 针对这些情况,我们提供 enterprise support:直接对接 Pydantic 工程师、7x24 小时优先支持,以及与你的运营方式匹配的 SLA。 协议中会明确我们覆盖的 release 版本线,以及当某个版本受到漏洞影响时我们如何与你协同处理。 欢迎联系我们,讨论你团队的需求。

对路线图有疑问或反馈?欢迎到我们的社区 Slack 参与讨论,或在 GitHub 上发起 discussion。

评论 (0)