政策

版本政策

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

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

API 重大更改应该只发生在主要版本中。这些更改将被记录下来，并提供关于更改内容、更改原因以及如何将现有代码迁移到新行为的明确指导。

只要有可能，就会提供弃用路径，而不是彻底的破坏性更改。

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

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

• 将强制弃用的 pandas 版本。

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

弃用只会在主要版本中强制执行。例如，如果某个行为在 pandas 1.2.0 中已弃用，则该行为将在 1.x 系列的所有版本中继续有效，但会出现警告。该行为将发生变化，并在下一个主要版本 (2.0.0) 中删除弃用内容。

笔记

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

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

Python 支持

pandas 反映了Python 支持的 NumPy 指南。

安全政策

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