Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Rust for Python Programmers: Complete Training Guide / 面向 Python 程序员的 Rust 完整培训指南

A comprehensive guide to learning Rust for developers with Python experience. This guide covers everything from basic syntax to advanced patterns, focusing on the conceptual shifts required when moving from a dynamically-typed, garbage-collected language to a statically-typed systems language with compile-time memory safety.

这是一本面向 Python 开发者的 Rust 学习指南，涵盖从基础语法到高级模式的内容，重点讲解从动态类型、垃圾回收语言迁移到具备编译期内存安全保证的静态类型系统语言时所需要的思维转变。

How to Use This Book / 如何使用本书

Self-study format: Work through Part I (ch 1-6) first - these map closely to Python concepts you already know. Part II (ch 7-12) introduces Rust-specific ideas like ownership and traits. Part III (ch 13-16) covers advanced topics and migration.

自学建议：先学习第一部分（第 1-6 章），这些内容与 Python 中已有概念最接近。第二部分（第 7-12 章）会引入 Rust 特有概念，如所有权和 trait。第三部分（第 13-16 章）讨论高级主题与迁移问题。

Pacing recommendations / 学习节奏建议：

Chapters / 章节Topic / 主题Suggested Time / 建议时间Checkpoint / 检查点
1-4Setup, types, control flow / 环境、类型、控制流1 day / 1 天You can write a CLI temperature converter in Rust / 你可以用 Rust 写出命令行温度转换器
5-6Data structures, enums, pattern matching / 数据结构、枚举、模式匹配1-2 days / 1-2 天You can define an enum with data and match exhaustively on it / 你可以定义携带数据的枚举并用 match 完整匹配
7Ownership and borrowing / 所有权与借用1-2 days / 1-2 天You can explain why let s2 = s1 invalidates s1 / 你可以解释为什么 let s2 = s1 会使 s1 失效
8-9Modules, error handling / 模块、错误处理1 day / 1 天You can create a multi-file project that propagates errors with ? / 你可以创建一个多文件项目并用 ? 传播错误
10-12Traits, generics, closures, iterators / Trait、泛型、闭包、迭代器1-2 days / 1-2 天You can translate a list comprehension to an iterator chain / 你可以把列表推导式翻译成迭代器链
13Concurrency / 并发1 day / 1 天You can write a thread-safe counter with Arc<Mutex<T>> / 你可以用 Arc<Mutex<T>> 写出线程安全计数器
14Unsafe, PyO3, testing / Unsafe、PyO3、测试1 day / 1 天You can call a Rust function from Python via PyO3 / 你可以通过 PyO3 从 Python 调用 Rust 函数
15-16Migration, best practices / 迁移、最佳实践At your own pace / 自定节奏Reference material - consult as you write real code / 作为参考材料，在实际开发时按需查阅
17Capstone project / 综合项目2-3 days / 2-3 天Build a complete CLI app tying everything together / 构建一个整合各章节内容的完整命令行应用

How to use the exercises / 如何使用练习：

  • Chapters include hands-on exercises in collapsible <details> blocks with solutions / 各章包含可折叠 <details> 区块中的动手练习及答案
  • Always try the exercise before expanding the solution. Struggling with the borrow checker is part of learning - the compiler’s error messages are your teacher / 总是先尝试练习，再展开答案。 与借用检查器斗争本身就是学习过程，编译器的报错就是老师
  • If you’re stuck for more than 15 minutes, expand the solution, study it, then close it and try again from scratch / 如果卡住超过 15 分钟，就展开答案学习，然后收起并重新独立完成一次
  • The Rust Playground lets you run code without a local install / Rust Playground 允许你在未本地安装 Rust 的情况下运行代码

Difficulty indicators / 难度标记：

  • 🟢 Beginner - Direct translation from Python concepts / 初级：可以直接从 Python 概念迁移
  • 🟡 Intermediate - Requires understanding ownership or traits / 中级：需要理解所有权或 trait
  • 🔶 Advanced - Lifetimes, async internals, or unsafe code / 高级：生命周期、async 内部机制或 unsafe 代码

When you hit a wall / 遇到卡点时：

  • Read the compiler error message carefully - Rust’s errors are exceptionally helpful / 仔细阅读编译器错误信息，Rust 的错误提示通常非常有帮助
  • Re-read the relevant section; concepts like ownership (ch7) often click on the second pass / 重读相关小节，像所有权这样的概念往往第二遍才真正理解
  • The Rust standard library docs are excellent - search for any type or method / Rust 标准库文档 非常优秀，遇到类型或方法都值得去查
  • For deeper async patterns, see the companion Async Rust Training / 如需更深入的异步内容，请参考配套的 Async Rust Training

Table of Contents / 目录

Part I - Foundations / 第一部分：基础

1. Introduction and Motivation / 1. 引言与动机 🟢

2. Getting Started / 2. 快速开始 🟢

3. Built-in Types and Variables / 3. 内建类型与变量 🟢

4. Control Flow / 4. 控制流 🟢

5. Data Structures and Collections / 5. 数据结构与集合 🟢

6. Enums and Pattern Matching / 6. 枚举与模式匹配 🟡

Part II - Core Concepts / 第二部分：核心概念

7. Ownership and Borrowing / 7. 所有权与借用 🟡

8. Crates and Modules / 8. Crate 与模块 🟢

9. Error Handling / 9. 错误处理 🟡

10. Traits and Generics / 10. Trait 与泛型 🟡

11. From and Into Traits / 11. From 与 Into Trait 🟡

12. Closures and Iterators / 12. 闭包与迭代器 🟡

Part III - Advanced Topics & Migration / 第三部分：高级主题与迁移

13. Concurrency / 13. 并发 🔶

14. Unsafe Rust, FFI, and Testing / 14. Unsafe Rust、FFI 与测试 🔶

15. Migration Patterns / 15. 迁移模式 🟡

16. Best Practices / 16. 最佳实践 🟡

Part IV - Capstone / 第四部分：综合项目

17. Capstone Project: CLI Task Manager / 17. 综合项目：命令行任务管理器 🔶