版本控制和 API 稳定性

版本控制

Scrapy 版本号由 3 个数字组成：A.B.C

• A 是主版本号。它很少改变，表示非常重大的改动。

• B 是发布版本号。它将包含许多更改，包括新功能和可能破坏向后兼容性的内容，尽管我们力求将此类情况降至最低。

• C 是错误修复版本号。

向后不兼容项会在 发布说明 中明确提及，升级前可能需要特别注意。

开发版本不遵循三段式版本号，通常以带有 dev 后缀的版本发布，例如 1.3dev。

注意

在 Scrapy 0.* 系列中，Scrapy 使用奇数版本号作为开发版本。从 Scrapy 1.0 开始，情况已不再如此。

从 Scrapy 1.0 开始，所有版本都应被视为生产就绪版本。

例如

• 1.1.1 是 1.1 系列的第一个错误修复版本（可在生产环境安全使用）

API 稳定性

API 稳定性是 1.0 版本的主要目标之一。

以单个破折号（_）开头的方法或函数是私有的，绝不应被视为稳定。

此外，请记住稳定不代表完整：稳定的 API 可能会增加新的方法或功能，但现有方法应保持相同的工作方式。

弃用策略

我们致力于为已弃用的 Scrapy 功能提供至少 1 年的支持。

例如，如果某个功能在 2020 年 6 月 15 日发布的 Scrapy 版本中被弃用，那么该功能在 2021 年 6 月 14 日或之前发布的版本中应继续可用。

一年后的任何新 Scrapy 版本可能会移除对该弃用功能的支持。

Scrapy 版本中移除的所有弃用功能都会在 发布说明 中明确提及。