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
错误修复。 - 使用版本排序(按
x8
、x16
、x32
、x64
、x128
的顺序排序)。 - 将 “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 相对应的风格版本。