欢迎浏览 Rust 项目 提供的文档概述。本页面包含指向各种有用参考资料的链接,其中大部分都可以离线使用(如果使用 rustup doc 打开)。许多资源都以“书籍”的形式呈现;我们将这些书籍统称为“Rust 书架”。有些书籍内容丰富,有些则比较简短。
所有这些书籍都由 Rust 组织管理,但也包含其他非官方文档资源!
如果您只是在寻找标准库参考,请访问:Rust API 文档
如果您想学习 Rust,那么本节就是为您准备的!所有这些资源都假设您以前有过编程经验,但不要求使用任何特定语言。
《Rust 编程语言》 被亲切地称为“The Book”,它将从基本原理出发,为您概述这门语言。您将在学习过程中构建一些项目,并在最后对如何使用这门语言有一个扎实的掌握。
如果您不喜欢阅读数百页关于一门语言的文字,那么 Rust 示例 就是您的不二之选。RBE 通过大量的代码示例来展示 Rust 的用法,而无需过多文字描述。它还包含练习!
Rustlings 指导您下载和设置 Rust 工具链,然后提供一个交互式工具,教您如何用 Rust 解决编码挑战。
Rust Playground 是一个尝试和分享代码片段,或体验一些最流行的 crates 的好地方。
一旦您熟悉了这门语言,这些资源可以帮助您将其付诸实践。
Rust 的标准库拥有 丰富的 API 文档,其中包含如何使用各种功能的说明,以及完成各种任务的示例代码。代码示例在悬停时会显示一个“运行”按钮,点击该按钮即可在 Playground 中打开该示例。
每当您在一个 crate 中工作时,cargo doc --open 都会为您的项目及其所有依赖项生成文档,并使用正确的版本在浏览器中打开它。添加 --document-private-items 标志还可以显示未标记为 pub 的项目。
发行说明 描述了 Rust 工具链和语言的变更历史。
版本指南 描述了 Rust 版本及其差异。最新版本的工具链支持所有历史版本。
《rustc 书籍》 描述了 Rust 编译器 rustc。
《Cargo 书籍》 是 Rust 构建工具和依赖管理器 Cargo 的指南。
《Rustdoc 书籍》 描述了我们的文档工具 rustdoc。
《Clippy 书籍》 描述了我们的静态分析器 Clippy。
Rust 的许多错误都带有错误代码,您可以向编译器请求有关这些错误的扩展诊断信息(使用 rustc --explain)。如果您愿意,也可以在这里阅读它们:rustc 错误代码
一旦您对这门语言相当熟悉,您可能会发现以下高级资源很有用。
参考手册 不是正式的规范,但比 The Book 更详细、更全面。
Rust 风格指南 描述了 Rust 代码的标准格式。大多数开发者使用 cargo fmt 来调用 rustfmt 并自动格式化代码(结果与本风格指南一致)。
Rust 秘典 是您学习不安全 Rust 黑魔法的指南。它有时也被称为“The ’nomicon”。
不稳定特性书籍 包含不稳定特性的文档。
《rustc 指南》 介绍了编译器的工作原理以及如何为其做出贡献。如果您想从源代码构建或修改 Rust 编译器(例如,将其用于非标准目标),这将非常有用。
在特定领域使用 Rust 时,请考虑使用以下针对每个领域量身定制的资源。
在为裸机或嵌入式 Linux 系统开发时,您可能会发现 嵌入式工作组 维护的以下资源很有用。
《嵌入式 Rust 书籍》 面向熟悉嵌入式开发和 Rust,但尚未将 Rust 用于嵌入式开发的开发者。