策略

版本策略

pandas 使用了语义化版本控制 (SemVer) 的一个宽松变体，用于管理弃用、API 兼容性和版本编号。

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

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

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

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

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

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

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

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

注意

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

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

Python 支持

pandas 遵循 NumPy 的 Python 支持指南。

安全策略

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