Rust 编程语言

本仓库包含《Rust 编程语言》一书的源代码。

该书的纸质版可从 No Starch Press 购买。

您也可以在线免费阅读本书。请查看最新的 稳定版、测试版 或 每日构建版 Rust 发布中附带的图书。请注意，这些版本中的问题可能已在本仓库中修复，因为这些发布版本更新频率较低。

查看 发布版本 以下载书中出现的所有代码示例。

要求

构建本书需要 mdBook，最好使用与 rust-lang/rust 在 此文件 中相同的版本。获取方法：

$ cargo install mdbook --locked --version <版本号>

构建

要构建本书，请输入：

$ mdbook build

输出将位于 book 子目录中。要查看，请在网页浏览器中打开。

Firefox:

$ firefox book/index.html                       # Linux
$ open -a "Firefox" book/index.html             # OS X
$ Start-Process "firefox.exe" .\book\index.html # Windows (PowerShell)
$ start firefox.exe .\book\index.html           # Windows (Cmd)

Chrome:

$ google-chrome book/index.html                 # Linux
$ open -a "Google Chrome" book/index.html       # OS X
$ Start-Process "chrome.exe" .\book\index.html  # Windows (PowerShell)
$ start chrome.exe .\book\index.html            # Windows (Cmd)

运行测试：

$ mdbook test

贡献

我们非常欢迎您的帮助！请查看 CONTRIBUTING.md 了解我们正在寻求的贡献类型。

由于本书已付印，且我们希望尽可能保持在线版本与印刷版本一致，因此我们处理您的问题或拉取请求可能需要比您预期更长的时间。

到目前为止，我们一直在进行较大的修订，以配合 Rust 版本。在这些大修订之间，我们只会修正错误。如果您的问题或拉取请求不是严格修复错误，可能会等到下一次大修订时才会处理：预计需要数月或数年的时间。感谢您的耐心等待！

翻译

我们非常欢迎帮助翻译本书！请查看 Translations 标签，参与正在进行的翻译工作。如果要开始新语言的翻译，请开启一个新的 issue！我们正在等待 [mdbook 支持] 多语言功能，然后才会合并任何翻译，但欢迎开始翻译工作！

拼写检查

要扫描源文件中的拼写错误，可以使用 ci 目录中的 spellcheck.sh 脚本。它需要一个有效单词的字典，该字典位于 ci/dictionary.txt 中。如果脚本产生误报（比如，您使用了 BTreeMap 这个词，但脚本认为它无效），您需要将这个词添加到 ci/dictionary.txt 中（保持排序以保持一致性）。