全面的 Rust 🦀

这个仓库包含了全面的 Rust 🦀 的源代码，这是由 Android 团队开发的多天 Rust 课程。该课程涵盖了 Rust 的所有方面，从基本语法到泛型和错误处理。它还包括对Android、Chromium、裸机和并发的深入探讨。

在 https://google.github.io/comprehensive-rust/ 阅读课程。

课程格式和目标受众

该课程在 Google 内部用于教授有经验的软件工程师学习 Rust。他们通常具有 C++ 或 Java 背景。

课程在课堂环境中进行教学，我们希望它对那些想要教授团队 Rust 的人也有用。对于自学来说，这门课程的用处会较小，因为你会错过课堂上发生的讨论。你看不到问题和答案，也看不到我们在浏览代码示例时触发的编译器错误。我们希望通过演讲者注释和发布视频来改善这一点。

媒体报道

网络上关于全面的 Rust 的文章和博客文章：

• 2023-09-08： 5天教授Rust。 全面的 Rust 被用作为期5天的大学 Rust 课程的基础。
• 2023-09-21： 通过培训扩大 Rust 的采用。 我们发布了一篇博客文章，详细介绍了课程的开发。
• 2023-10-02： 在寻找 Rust 开发者时，公司转向内部培训。 关于微软、谷歌和其他公司如何培训人员学习 Rust。

构建

该课程使用以下几个工具构建：

• mdbook
• mdbook-svgbob
• mdbook-i18n-helpers 和 i18n-report
• mdbook-exerciser
• mdbook-course

此外，mdbook-linkcheck 用于检查内部链接。

首先，按照 https://rustup.rs/ 的说明安装 Rust。然后克隆这个仓库：

git clone https://github.com/google/comprehensive-rust/
cd comprehensive-rust

然后使用以下命令安装这些工具：

cargo install mdbook
cargo install --locked mdbook-svgbob
cargo install --locked mdbook-i18n-helpers
cargo install --locked i18n-report
cargo install --locked mdbook-linkcheck
cargo install --locked --path mdbook-exerciser
cargo install --locked --path mdbook-course

运行

mdbook test

来测试所有包含的 Rust 代码片段。运行

mdbook serve

来启动一个包含课程内容的 Web 服务器。你可以在 http://localhost:3000 找到内容。你可以使用 mdbook build 在 book/ 目录中创建课程的静态版本。注意，你必须单独构建并压缩练习，并将它们添加到 book/html。要构建课程的任何翻译版本，请运行 MDBOOK_BOOK__LANGUAGE=xx mdbook build -d book/xx，其中 xx 是 ISO 639 语言代码（例如，da 表示丹麦语翻译）。TRANSLATIONS.md 包含了进一步的说明。

注意 在 Windows 上，你需要启用符号链接（git config --global core.symlinks true）和开发者模式。

联系方式

如有问题或意见，请联系 Martin Geisler 或在 GitHub 上开始讨论。我们很乐意听到你的反馈。