政策

版本政策

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

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

API 破坏性更改应仅发生在 **major** 版本中。这些更改将被记录，并提供关于更改内容、原因以及如何迁移现有代码以适应新行为的明确指导。

只要有可能，将提供弃用路径，而不是直接的破坏性更改。

pandas 将在 **minor** 版本中引入弃用。这些弃用将保留现有行为，同时发出警告，提供关于以下方面的指导：

• 如果存在替代方案，如何实现类似的行为

• 弃用将被强制执行的 pandas 版本。

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

弃用将仅在 **major** 版本中强制执行。例如，如果 pandas 1.2.0 中弃用了一项行为，那么在 1.x 系列的所有版本中，该行为仍将继续工作，但会发出警告。该行为将在下一个 major 版本 (2.0.0) 中更改，并移除弃用。

注意

pandas 有时会通过 minor 或 patch 版本进行*行为更改*的 bug 修复。一个更改是 bug 修复还是 API 破坏性更改是一个判断问题。我们将尽力而为，并欢迎您在 issue tracker 或邮件列表中参与开发讨论。

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

Python 支持

pandas 遵循 SPEC 0 Python 支持指南。

安全政策

要向 pandas 报告安全漏洞，请访问 pandas-dev/pandas 并按照那里的说明进行操作。