book

本仓库保存了《Rust编程语言》的源码，这是Rust语言的权威入门书籍。成书由No Starch Press出版印刷，同时也在网上免费提供，随Rust的稳定版、测试版和夜间版一同发布（不过这些捆绑副本可能滞后于此处所做的修复）。发布页面提供了书中所有代码清单的可下载代码。 本书以Markdown编写，并使用mdBook（Rust社区的书籍静态站点生成器）渲染。构建需要安装特定版本的mdBook（与rust-lang/rust的rustbook工具中固定的版本匹配），通过`cargo install mdbook --locked --version <版本号>`安装，然后运行`mdbook build`在`book`子目录中生成静态站点，可在任何浏览器中查看。README文档记录了在Linux、macOS和Windows（包括PowerShell和Cmd）上启动Firefox和Chrome浏览器的命令。代码示例的测试位于`packages/trpl`下，通过`mdbook test --library-path packages/trpl/target/debug/deps`运行。 欢迎通过CONTRIBUTING.md指南贡献，但由于书籍已印刷且维护者旨在保持在线版本与印刷版接近，修订会围绕Rust版本发布进行批量处理。在这些较大修订之间，仅合并严格的错误修正，因此非错误拉取请求可能等待数月或数年。翻译通过Translations标签跟踪，新语言工作可作为问题开启，但合并需等待mdBook的多语言支持。`ci/spellcheck.sh`脚本和`ci/dictionary.txt`字典支持拼写检查，误报（如`BTreeMap`等标识符）按排序顺序添加到字典中。 总体而言，这是一个文档和教育项目，而非运行时工具：其对用户的价值在于作为Rust的权威学习资源，具有完善的构建管道、代码示例测试框架以及结构化的贡献和翻译工作流。