策略#

版本策略#

pandas 使用语义版本控制（SemVer）的宽松变体来管理废弃、API 兼容性和版本编号。

pandas 的发布版本号由 MAJOR.MINOR.PATCH 组成。

API 破坏性更改只应发生在 主版本 发布中。这些更改将被记录，并提供清晰的指导，说明更改了什么、为什么更改以及如何将现有代码迁移到新行为。

在可能的情况下，将提供弃用路径，而不是直接的破坏性更改。

pandas 将在 次版本 发布中引入弃用。这些弃用将保留现有行为，同时发出警告，提供指导，说明

我们不会在补丁版本中引入新的弃用。

弃用只会在 主版本 发布中强制执行。例如，如果某个行为在 pandas 1.2.0 中被弃用，它将在 1.x 系列的所有发布中继续工作，并发出警告。该行为将在下一个主版本 (2.0.0) 中更改并移除弃用。

注意

pandas 有时会在次版本或补丁版本中进行 行为更改 的错误修复。某个更改是错误修复还是 API 破坏性更改，这是一个判断性问题。我们将尽力而为，并邀请您在问题跟踪器或邮件列表中参与开发讨论。

这些策略不适用于文档中标记为 实验性 的功能。pandas 可能随时更改实验性功能的行为。

要向 pandas 报告安全漏洞，请访问 pandas-dev/pandas 并查看那里的说明。