RustTraining README

The project's README from github.com/microsoft/RustTraining. As one markdown file: README.md.

License This project is dual-licensed under the MIT License and Creative Commons Attribution 4.0 International (CC-BY-4.0).

Trademarks This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

Rust Training Books

Seven training courses covering Rust from different programming backgrounds, plus deep-dives on async, advanced patterns, and engineering practices.

This material combines original content with ideas and examples inspired by some of the best resources in the Rust ecosystem. The goal is to present an in-depth, technically accurate curriculum that weaves together knowledge scattered across books, blogs, conference talks, and video series into a cohesive, pedagogically structured experience.

Disclaimer: These books are training material, not an authoritative reference. While we strive for accuracy, always verify critical details against the official Rust documentation and the Rust Reference.

Inspirations & Acknowledgments

📖 Start Reading

Pick the book that matches your background. Books are grouped by complexity so you can chart a learning path:

Level Description
🟢 Bridge Learn Rust coming from another language — start here
🔵 Deep Dive Focused exploration of a major Rust subsystem
🟡 Advanced Patterns and techniques for experienced Rustaceans
🟣 Expert Cutting-edge type-level and correctness techniques
🟤 Practices Engineering, tooling, and production readiness
Book Level Who it's for
Rust for C/C++ Programmers 🟢 Bridge Move semantics, RAII, FFI, embedded, no_std
Rust for C# Programmers 🟢 Bridge Swift / C# / Java → ownership & type system
Rust for Python Programmers 🟢 Bridge Dynamic → static typing, GIL-free concurrency
Async Rust 🔵 Deep Dive Tokio, streams, cancellation safety
Rust Patterns 🟡 Advanced Pin, allocators, lock-free structures, unsafe
Type-Driven Correctness 🟣 Expert Type-state, phantom types, capability tokens
Rust Engineering Practices 🟤 Practices Build scripts, cross-compilation, CI/CD, Miri

Each book has 15–16 chapters with Mermaid diagrams, editable Rust playgrounds, exercises, and full-text search.

Tip: Browse the rendered books with sidebar navigation and search at the GitHub Pages site.

Local preview: For offline reading or while contributing (install Rust first):

git clone https://github.com/microsoft/RustTraining.git
cd RustTraining
cargo install mdbook mdbook-mermaid
cargo xtask serve    # http://localhost:3000

🔧 For Maintainers

Building, serving, and editing the books locally

Prerequisites

Install Rust via rustup if you haven't already, then:

cargo install [email protected] [email protected]

Clone the repo

git clone https://github.com/microsoft/RustTraining.git
cd RustTraining

Build & serve

cargo xtask build               # Build all books into site/ (local preview)
cargo xtask serve               # Build and serve at http://localhost:3000
cargo xtask deploy              # Build all books into docs/ (for GitHub Pages)
cargo xtask clean               # Remove site/ and docs/

To build or serve a single book:

cd c-cpp-book && mdbook serve --open    # http://localhost:3000

Deployment

The site auto-deploys to GitHub Pages on push to main via .github/workflows/pages.yml. No manual steps needed.

RustTraining (microsoft/RustTraining)

Searching Database…

Что это такое?Семь бесплатных учебников по Rust от Microsoft, которые проведут вас от другого языка программирования до async, продвинутых паттернов и инженерных практик.
Это один большой курс или отдельные книги?Семь отдельных книг, сгруппированных по уровням сложности: зелёная Bridge — для изучения Rust с другого языка, синие Deep Dives, жёлтые Advanced, фиолетовые Expert и коричневые Practices.
С чего начать?Выберите книгу под свой уровень подготовки — уровень Bridge помечен как стартовая точка. Сверстанные книги с боковой навигацией и поиском находятся на сайте GitHub Pages.
Можно ли считать эти книги официальным справочником по Rust?Нет — авторы предупреждают, что это учебный материал, а не авторитетный справочник, и важные детали стоит сверять с официальной документацией Rust и Rust Reference.
Мне нужно уже уметь программировать?Желательно, чтобы вы уже программировали на другом языке: книги Bridge рассчитаны на разработчиков C/C++, C# (а также Java или Swift) и Python. Трека с нуля для совсем новичков нет.
Можно читать их офлайн или только в интернете?Для чтения на сайте GitHub Pages нужен только браузер; чтобы читать офлайн или участвовать в проекте, установите Rust через rustup, склонируйте репозиторий и соберите или запустите отдельную книгу локально.
На какой лицензии распространяется материал — могу ли я использовать его в своих курсах?Двойная лицензия MIT и Creative Commons Attribution 4.0 (CC-BY-4.0), так что повторное использование допустимо с указанием авторства; на логотипы по-прежнему распространяются правила использования товарных знаков Microsoft.
Что есть внутри каждой книги?Каждая книга состоит из 15–16 глав с диаграммами Mermaid, редактируемыми Rust-плейграундами, упражнениями и полнотекстовым поиском; в размещённой версии добавлена боковая навигация.
Что разбирают более глубокие книги, когда основы уже освоены?Async Rust (Tokio, стримы, безопасность отмены), Rust Patterns (Pin, аллокаторы, lock-free структуры, unsafe), Type-Driven Correctness (type-state, phantom-типы, capability-токены) и Engineering Practices (build-скрипты, кросс-компиляция, CI/CD, Miri).
Материал оригинальный или собран из других источников?Он сочетает оригинальный контент с идеями и примерами, навеянными известными ресурсами по Rust — The Rust Programming Language, глубокими разборами Jon Gjengset, Rust Atomics and Locks Mara Bos, Rust by Example и другими — перестроенными в единую педагогическую программу.
Сайт обновляется автоматически?Да — сайт автоматически разворачивается на GitHub Pages при каждом пуше в main без ручных действий, а репозиторий совсем новый, создан в марте 2026 года.
Creator
microsoft
Size
1.6 MB
Stars
14.9K
Updated
CommitSep 11
Age
7mo
Commits · 90 Days