rust-lang/book
GitHub: rust-lang/book
Rust 官方编程语言教材的源码仓库,涵盖从基础语法到高级特性的完整学习内容。
Stars: 17468 | Forks: 3962
# Rust 程序设计语言

本仓库包含“Rust 程序设计语言”一书的源码。
[该书由 No Starch Press 以纸质书形式出版][nostarch]。
您也可以免费在线阅读本书。请参阅随最新 [stable]、[beta] 或 [nightly] Rust 版本发布的书籍。请注意,这些版本中的问题可能已在本仓库中修复,因为这些版本的更新频率较低。
请参阅 [releases] 以下载本书中出现的所有代码清单的代码。
## 要求
构建本书需要 [mdBook],最好是 [this file][rust-mdbook] 中 rust-lang/rust 使用的相同版本。获取方式:
```
$ cargo install mdbook --locked --version
```
## 构建
要构建本书,请输入:
```
$ mdbook build
```
输出将位于 `book` 子目录中。要查看它,请在您的 web 浏览器中打开它。
_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)
```
要运行测试:
```
$ cd packages/trpl
$ mdbook test --library-path packages/trpl/target/debug/deps
```
### 翻译
我们非常乐意帮助翻译本书!请查看 [Translations] 标签以加入当前正在进行的工作。开启一个新的 issue 来开始一种新语言的翻译工作!在合并任何内容之前,我们正在等待针对多语言的 [mdbook support],但请随时开始!
## 拼写检查
要扫描源文件中的拼写错误,您可以使用 `ci` 目录中提供的 `spellcheck.sh` 脚本。它需要一个有效单词的字典,该字典在 `ci/dictionary.txt` 中提供。如果脚本产生误报(例如,您使用了 `BTreeMap` 这个词,而脚本认为它无效),您需要将此词添加到 `ci/dictionary.txt` 中(为了保持一致性,请保持排序顺序)。
标签:mdBook, Rust, Rust语言, 代码示例, 可视化界面, 学习资源, 官方教程, 开源书籍, 技术文档, 教程, 数据分析, 文档生成, 系统编程, 编程入门, 编程语言, 网络流量审计, 计算机科学, 软件开发, 通知系统, 防御加固