版本控制和API稳定性

版本

Scrapy 版本号有3个数字：A.B.C

• A 是主要版本。这将很少改变，并将意味着非常大的变化。

• B 是版本号。这将包括许多更改，包括可能破坏向后兼容性的功能和内容，尽管我们努力将这些情况保持在最低限度。

• C 是错误修复版本号。

向后兼容性在：ref：`release notes <news>`中明确提到，在升级之前可能需要特别注意。

开发版本不遵循3号版本，通常发布为 dev 后缀版本，例如 1.3dev .

注解

带Scrapy 0.*系列，使用Scrapy odd-numbered versions for development releases . 从Scrapy1.0开始就不再是这样了。

从Scrapy1.0开始，所有版本都应视为生产就绪。

例如：

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

API稳定性

API的稳定性是 1.0 释放。

以单个破折号开头的方法或函数（ _ ）是私人的，不应该被当作稳定的。

另外，请记住，稳定并不意味着完整：稳定的API可以增加新的方法或功能，但是现有的方法应该保持相同的工作方式。

弃用政策

我们的目标是保持对过时的垃圾特性的支持至少一年。

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

一年后有新的发痒症状吗 may 删除对该已弃用功能的支持。

在旧版本中删除的所有不推荐的特性都在 release notes .