政策#

版本策略#

在 1.0.0 版更改.

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

Pandas放行号由以下部分组成 MAJOR.MINOR.PATCH

API中断更改应仅发生在 主修 发布。这些更改将被记录下来,并提供关于更改内容、更改原因以及如何将现有代码迁移到新行为的明确指导。

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

Pandas将在中国引入不受欢迎的动物 小调 发布。这些弃用将保留现有行为,同时发出警告,提供有关以下方面的指导:

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

  • 将强制执行这一弃用的Pandas版本。

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

弃用将仅在 主修 发布。例如,如果某个行为在Pandas 1.2.0中被弃用,它将在1.x系列的所有版本中继续工作,并发出警告。在下一个主要版本(2.0.0)中,这一行为将发生变化,不推荐使用。

备注

Pandas有时会让 行为改变 错误修复,作为次要或修补程序版本的一部分。无论更改是错误修复还是破坏API的更改,都需要进行判断。我们将尽最大努力,并邀请您参与问题跟踪器或邮件列表上的开发讨论。

这些策略不适用于标记为 实验性的 在文档中。Pandas可能会随时改变实验特征的行为。

对Python的支持#

Pandas只会放弃对特定版本(如3.6.x、3.7.x)的支持 主修小调 发布。