策略#

版本策略#

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 并查看那里的说明。