Rust 风格版本

默认的 Rust 风格会随着 Rust 本身的发展而演变。然而,为了避免破坏已建立的代码风格以及检查代码风格的 CI 任务,对默认 Rust 风格的更改仅会出现在风格版本中。

以给定的 Rust 版本 编写的代码默认使用相应的 Rust 风格版本。为了更容易地将代码风格迁移与 Rust 版本之间的语义更改分开,格式化工具(如 rustfmt)允许将风格版本的更新与 Rust 版本的更新分开进行。

当前版本的风格指南描述了最新的 Rust 风格版本。每个不同的过往风格都将有对应的风格指南存档版本。

请注意,风格指南的存档版本不记录在该版本风格指南存档时不存在的较新 Rust 构造的格式化。然而,每个风格版本仍将格式化在该 Rust 版本中有效的所有构造,较新构造的风格来自第一个后续风格版本,该版本为该构造提供了格式化规则(不包含来自该风格版本的任何系统性/全局更改)。

并非所有 Rust 版本都有对应的 Rust 风格更改。例如,Rust 2015、Rust 2018 和 Rust 2021 都使用相同的风格版本。

Rust 2024 风格版本

本风格指南描述了 Rust 2024 风格版本。Rust 2024 风格版本目前仅在 nightly 版本中提供,并且在 Rust 2024 发布之前可能会发生更改。

有关 Rust 2024 风格版本中更改的完整历史记录,请参阅风格指南的 git 历史记录。Rust 2024 风格版本中的显著更改包括

  • 各种 rustfmt 错误修复。
  • 使用版本排序(按 x8x16x32x64x128 的顺序排序)。
  • 将 “ASCIIbetical” 排序更改为 Unicode 感知的 “非小写字母优先于小写字母” 排序。

Rust 2015/2018/2021 风格版本

位于 https://github.com/rust-lang/rust/tree/37343f4a4d4ed7ad0891cb79e8eb25acf43fb821/src/doc/style-guide/src 的风格指南存档版本描述了与 Rust 2015、Rust 2018 和 Rust 2021 相对应的风格版本。