附录 E - 版本

在第 1 章中,你看到 cargo new 会在你的 Cargo.toml 文件中添加一些关于版本的元数据。本附录将讨论这意味着什么!

Rust 语言和编译器具有六周的发布周期,这意味着用户可以获得持续不断的新功能。其他编程语言较少发布较大的更改;而 Rust 更频繁地发布较小的更新。一段时间后,所有这些微小的变化都会累积起来。但是,从一个版本到另一个版本,很难回顾并说:“哇,在 Rust 1.10 和 Rust 1.31 之间,Rust 已经发生了很大的变化!”

每两到三年,Rust 团队会发布一个新的 Rust 版本。每个版本都将已经实现的功能整合到一个清晰的软件包中,其中包含完全更新的文档和工具。新版本作为通常的六周发布过程的一部分发布。

版本为不同的人服务于不同的目的

  • 对于活跃的 Rust 用户来说,新版本将增量变化整合到一个易于理解的软件包中。
  • 对于非用户来说,新版本标志着一些重大进展已经实现,这可能使 Rust 值得再次关注。
  • 对于那些开发 Rust 的人来说,新版本为整个项目提供了一个集结点。

在撰写本文时,有三个 Rust 版本可用:Rust 2015、Rust 2018 和 Rust 2021。本书是使用 Rust 2021 版本惯用法编写的。

Cargo.toml 中的 edition 键指示编译器应为你的代码使用哪个版本。如果该键不存在,则 Rust 出于向后兼容性的原因将 2015 用作版本值。

每个项目都可以选择使用默认的 2015 版本以外的版本。版本可能包含不兼容的更改,例如包含与代码中的标识符冲突的新关键字。但是,除非你选择加入这些更改,否则即使你升级使用的 Rust 编译器版本,你的代码也将继续编译。

所有 Rust 编译器版本都支持该编译器发布之前存在的任何版本,并且它们可以将任何受支持的版本的 crate 链接在一起。版本更改仅影响编译器最初解析代码的方式。因此,如果你使用的是 Rust 2015,而你的一个依赖项使用的是 Rust 2018,则你的项目将编译并能够使用该依赖项。相反的情况,即你的项目使用 Rust 2018,而依赖项使用 Rust 2015,也同样适用。

需要明确的是:大多数功能在所有版本上都可用。使用任何 Rust 版本的开发人员都将继续看到随着新的稳定版本发布而带来的改进。但是,在某些情况下,主要是添加新关键字时,某些新功能可能仅在较新版本中可用。如果你想利用这些功能,则需要切换版本。

有关更多详细信息,版本指南 是一本关于版本的完整书籍,它列举了版本之间的差异,并解释了如何通过 cargo fix 自动将你的代码升级到新版本。