政策

版本策略

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

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

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

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

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

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

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

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

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

备注

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

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

Python 支持

pandas 遵循 SPEC 0 Python 支持指南。

安全策略

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