Skip to content

QUICKSTART.md

Latest commit

 

History

History
160 lines (109 loc) · 4.38 KB

QUICKSTART.md

File metadata and controls

160 lines (109 loc) · 4.38 KB

Quick Start Guide (快速开始)

欢迎来到 Rust Thinking！选择你的入口点。

🚀 5 分钟快速了解

如果你只有 5 分钟：

  1. 阅读 README.md 的"为什么做这个项目"部分
  2. 看一眼 00-why-rust/README.md
  3. 理解：在 AI 时代，Code Review 能力比写代码更重要

📚 30 分钟入门

如果你有 30 分钟：

# 1. 克隆仓库（如果你已经有了）
git clone https://github.com/tyxben/rust-thinking.git
cd rust-thinking

# 2. 运行第一个示例
cd 00-why-rust/examples/ai-generated-bug
cargo run

# 3. 阅读代码的注释
# 它展示了 AI 如何生成看似合理但有隐患的并发代码

🎓 完整学习计划

第 1 周：打基础（10-15 小时）

目标：深刻理解 Rust 的所有权系统

Day 1-2:

Day 3-4:

  • 深入理解 Move 语义
  • 运行 examples/move_demo.rs
  • 完成所有权章节的练习题

Day 5-7:

  • 学习借用和引用
  • 运行 examples/borrow_demo.rs
  • 解决编译器的各种错误消息（这是学习过程！）

第 2 周：学应用（10-15 小时）

目标：理解并发代码中的常见问题

Day 8-9:

Day 10-11:

  • 阅读 articles/ 中的文章
  • 特别是关于并发和 Code Review 的文章
  • 理论和实践结合

Day 12-14:

  • 完成 exercises/ 中的练习
  • 尝试自己设计一个并发系统
  • Review 别人的代码

🎯 根据你的背景选择入口

我来自 Python

你已经理解动态类型和 GC，现在学习：

  1. 所有权消除了 GC 的需要
  2. Move 让你控制内存生命周期
  3. 并发代码在 Rust 中更安全

推荐路径: 快速过完 01-basics，重点学 ai-review-cases

我来自 Java/C#

你已经有类型系统和 NullPointerException 的痛，现在学习：

  1. 所有权完全消除了 NPE
  2. Borrow Checker 在编译期检查所有问题
  3. 并发代码在编译期就被验证

推荐路径: 深入学 01-basics，ai-review-cases 会改变你对并发的理解

我来自 C/C++

你已经手动管理内存，现在学习：

  1. Ownership 是一种比指针更高级的资源管理方式
  2. Borrow Checker 让你安全地共享数据
  3. 再也不用担心 double-free 或 use-after-free

推荐路径: 快速扫过所有权，重点在 ai-review-cases 和并发

✅ 学习检查清单

完成每个部分后，问自己：

所有权部分

  • 我能解释 Rust 的三个所有权规则吗？
  • 我能区分 Move 和 Copy 吗？
  • 我能解读编译器的"借用冲突"错误吗？
  • 我能手写一个简单的所有权转移程序吗？

并发部分

  • 我能识别代码中的死锁风险吗？
  • 我能列举至少 3 种避免死锁的方法吗？
  • 我能比较 Mutex、RwLock、Channel 的优缺点吗？
  • 我能 review 一段并发代码并找出问题吗？

🤔 常见问题

Q: 我需要安装 Rust 吗？

是的。访问 rustup.rs 按照说明安装。

Q: 代码可以在哪些平台运行？

所有主流平台：Linux、macOS、Windows。Rust 编译速度快。

Q: 完成这个课程需要多久？

  • 快速浏览：2-3 天
  • 认真学习：2-3 周
  • 深度精通：6-8 周

Q: 我可以在哪里提问？

在 GitHub Issues 中提问。社区很友善！

📞 获得帮助

  1. 阅读 README - 80% 的问题都能在这里找到答案
  2. 查看代码注释 - 每个重要部分都有详细注释
  3. 运行示例 - 看代码工作的样子
  4. 提 Issue - 提问或报告问题
  5. 讨论 - 在 Discussions 中进行对话

🎉 现在开始！

选择一个你感兴趣的模块，深入学习：

  1. 想理解基础？ → 01-basics/03-ownership/
  2. 想看 AI 的 bug？ → ai-review-cases/case-01-deadlock/
  3. 想读深度文章？ → articles/
  4. 想自己练习？ → exercises/

加油！🦀

记住：Rust 学习曲线陡峭，但一旦通过，你会成为更好的程序员。