版本策略¶

首先，我们认识到从 Pydantic V1 到 V2 的过渡对某些用户来说已经并将继续是痛苦的。我们对这种痛苦表示歉意，这是纠正 V1 设计错误的不幸但必要的步骤。

不会再出现这种规模的中断性变更！

Pydantic V1¶

V1 的积极开发已经停止，但关键的错误修复和安全漏洞将在 V1 中修复，直到 Pydantic V3 发布。

我们不会在 V2 的次要版本中故意进行中断性变更。

标记为已弃用的功能将不会在下一个主要版本 V3 发布之前被移除。

当然，一些看似安全的更改和错误修复不可避免地会破坏某些用户的代码 — 必须链接到 xkcd。

以下更改将不会被视为中断性变更，并且可能在次要版本中发生：

可能导致现有代码破坏的错误修复，前提是该代码依赖于未记录的功能/构造。
更改 JSON Schema 引用的格式。
更改 ValidationError 异常的 msg、ctx 和 loc 字段。type 不会更改 — 如果您以编程方式解析错误消息，应该使用 type。
向 ValidationError 异常添加新键 — 例如，一旦我们迁移到新的 JSON 解析器，我们打算在验证 JSON 时向错误添加 line_number 和 column_number。
添加新的 ValidationError 错误。
更改 __repr__ 的行为，即使是公共类也是如此。
核心模式的内容（通常可在 Pydantic 模型的 __pydantic_core_schema__ 属性和类型适配器的 core_schema 下获得）可能在版本之间更改（这是 Pydantic 用于规划如何执行验证和序列化的低级格式）。

在所有情况下，我们将旨在最小化变动，并且仅在提高 Pydantic 对用户的质量有充分理由时才这样做。

我们预计未来大约每年发布一次新的主要版本，尽管如上所述，任何相关的中断性变更与 V1 到 V2 的过渡相比应该很容易修复。

在 Pydantic，我们喜欢快速行动和创新！为此，我们可能在次要版本中引入实验性功能。

使用文档

要了解我们当前的实验性功能，请参阅实验性功能文档。

请记住，实验性功能是正在进行中的工作。如果这些功能成功，它们最终将成为 Pydantic 的一部分。如果不成功，这些功能将在很少通知的情况下被移除。在实验阶段，功能的 API 和行为可能不稳定，并且对该功能所做的更改很可能不会向后兼容。

我们使用以下命名约定之一来指示某个功能是实验性的：

该功能位于 experimental 模块中。在这种情况下，您可以这样访问该功能：
```
from pydantic.experimental import feature_name
```
该功能位于主模块中，但前缀为 experimental_。这种情况发生在我们向主 pydantic 模块中已有的现有数据结构添加新字段、参数或方法时。

具有这些命名约定的新功能可能会更改或移除，我们正在寻求反馈和建议，然后再将它们作为 Pydantic 的永久部分。有关更多信息，请参阅反馈部分。

如果该功能不成功或不受欢迎，它将在很少通知的情况下被移除。弃用功能的位置将保留一个存根，其中包含错误消息。

感谢 streamlit 为我们新的实验性功能模式的生命周期和命名约定提供了灵感。

当满足以下条件时，Pydantic 将停止对 Python 版本的支持：