rust-lang /book
The Rust Programming Language
★ 18,571⑂ 4,183👁 223⑃ 2,719● 2,159▤ 4
More from this author
+2
Daily
18,571
stars
4,183
forks
223
watchers
2,719
prs
2,159
issues
4
releases
README
The Rust Programming Language !Build Status This repository contains the source of "The Rust Programming Language" book. [The book is available in dead-tree form from No Starch Press][nostarch]. [nostarch]: https://nostarch.com/rust-programming-language-2nd-edition You can also read the book for free online. Please see the book as shipped with the latest [stable], [beta], or [nightly] Rust releases. Be aware that issues in those versions may have been fixed in this repository already, as those releases are updated less frequently. [stable]: https://doc.rust-lang.org/stable/book/ [beta]: https://doc.rust-lang.org/beta/book/ [nightly]: https://doc.rust-lang.org/nightly/book/ See the [releases] to download just the code of all the code listings that appear in the book. [releases]: https://github.com/rust-lang/book/releases Requirements Building the book requires [mdBook], ideally the same version that rust-lang/rust uses in [this file][rust-mdbook]. To get it: [mdBook]: https://github.com/rust-lang/mdBook [rust-mdbook]: https://github.com/rust-lang/rust/blob/HEAD/src/tools/rustbook/Cargo.toml bash $ cargo install mdbook --locked --version Building To build the book, type: bash $ mdbook build The output will be in the book subdirectory. To check it out, open it in your web browser. _Firefox:_ bash $ 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:_ bash $ 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) To run the tests: bash $ cd packages/trpl $ mdbook test --library-path packages/trpl/target/debug/deps Contributing We'd love your help! Please see [CONTRIBUTING.md][contrib] to learn about the kinds of contributions we're looking for. [contrib]: https://github.com/rust-lang/book/blob/main/CONTRIBUTING.md Because the book is [printed][nostarch], and because we want to keep the online version of the book close to the print version when possible, it may take longer than you're used to for us to address your issue or pull request. So far, we've been doing a larger revision to coincide with Rust Editions. Between those larger revisions, we will only be correcting errors. If your issue or pull request isn't strictly fixing an error, it might sit until the next time that we're working on a large revision: expect on the order of months or years. Thank you for your patience! Translations We'd love help translating the book! See the [Translations] label to join in efforts that are currently in progress. Open a new issue to start working on a new language! We're waiting on [mdbook support] for multiple languages before we merge any in, but
Top issues
#661Spanish translation67 comments · 2017-05-01#808French translation63 comments · 2017-07-11#3235ch10-03 Explanation of lifetime bounds is confusing/incorrect34 comments · 2022-06-22#1032Hebrew translation32 comments · 2017-11-28#1386German Translation27 comments · 2018-06-01#2240Audiobook23 comments · 2020-02-01#1415Arabic Translation17 comments · 2018-06-22#2790If you had to delete a topic/section/chapter, what would it be?16 comments · 2021-07-16
Latest release
Rust 2024 Print Edition nostarch-third-printing 2025-12-19Text and code corresponding to the printing released on February 2026. ISBN-13: 9781718504448 Available from https://nostarch.com/rust-programming-language-3rd-edition