Handmade Hero 学习路线 Rust · Arch Linux · 全 667 集

这份路线在做什么

Handmade Hero 是 Casey Muratori 历时两年,从空文件夹到一个完整可玩游戏,每行代码都在视频里讲清楚的项目。原作是 C/C++ + Win32 + DirectSound + OpenGL,但你讨厌平台特定 API,所以这份路线把所有平台相关代码翻译成 Rust 的跨平台等价物——winit 管窗口、softbuffer 显示后缓冲、cpal 输出音频、gilrs 读手柄、libloading 做热重载、glutin+glow 在 Day 235 后接管 OpenGL。

学习目标不是「记住 winit 怎么用」,而是吃透每一行代码背后的原理——为什么 Casey 要把游戏代码做成 cdylib、为什么实体系统用索引不用指针、为什么 SIMD 必须 aligned、为什么光照要在 linear 空间计算、为什么 Casey 最后把 Minkowski 碰撞改成体素化方案。所有可以「用库」的地方(PNG、WAV、字体光栅、声音混音、内存分配器)Casey 都是从零写的,你也得从零写。

这是约 2.3 年的工程(每周 10–15 小时)。每一集配一个 checkbox,看完一集打勾,进度自动保存;可以用三个存档槽(左侧栏)把进度外化到同目录的 JSON 文件,就像游戏的存档/读档。每个 Phase 里有保姆级的中文讲解,每集配中文翻译 + 难度 + 类型 + 「本集你将学到」。下面还有 37 张概念卡,把 HH 用到的所有黑话(sRGB、Minkowski、depth peeling、SIMD...)都讲清楚。

🧠 递归式心智模型：从总图到细节

这份路线不是只让你“看懂代码”，而是让你不断建立可在脑中运行的系统模型。每一集都先问四个层次的问题：我现在处在系统的哪一层？这一层解决什么问题？这一层背后的原理是什么？我能不能不看代码就复述它怎么工作？

🛠️ 起步指南(保姆级)

在开始 Day 001 之前,先按这 8 步把环境搭好。每一步都给了可以复制粘贴的命令。如果你是 Linux/Rust 新手,不要跳步——后面跟 HH 的时候出问题,90% 都是基础环境问题。

🔧 技术栈对照表

原作的 Win32/C++ 翻译成下面的 Rust 跨平台方案。所有「原作手写」的部分(PNG/WAV/字体/mixer/分配器/软渲染器/debug 系统)继续手写——这才是 Handmade Hero 的核心价值。

明确不用: SDL2(藏太多细节)、minifb(切换 OpenGL 成本高)、rodio(藏 mixer)、image/hound/rusttype(违背「自己写」原则)、wgpu(太现代,与 HH 教学路线不符)。

💡 核心概念卡(37 张)

HH 全剧反复用到的核心概念。点击卡片看详细解释 + Casey 哪几集用到 + 深入学习资源。建议在跟到对应 Phase 前先扫一遍该 Phase 用到的卡。

⏱️ 每集工作流(单集 1.5–3 小时)

1. 看视频 — 用 guide.handmadehero.org 看 Casey 自己做的逐行注释版。Q&A 和 Bug-fix 集可以 1.5–2x 速听。
2. 读源码 diff — github.com/HandmadeHero/cpp 的 commit,或本地 git log -p --follow。
3. 笔记:在项目的 notes/day-NNN.md 记录:Casey 这集讲了什么、哪些是 Win32-ism 翻译成什么 Rust 等价物、涉及的 CS 概念。也可以在每集下方的「笔记」框里写。
4. 实现:严格跟着 Casey 的代码结构,不要发挥。Rust 学习者最大的诱惑是「用更 Rusty 的方式重写」——这会让你和 Casey 的代码偏离,后面调试就麻烦了。
5. 验证:运行后看画面是否与 Casey 当天的截图一致。声音、输入、性能都要对得上。
6. 提交:git commit -m "Day NNN: <title>"。强制自己每天一个 commit,长期下来就是完整学习记录。
7. 每周日复盘:在 journal.md 写这周学了什么、卡在哪里、下周重点。
8. 回来打勾:回到这份 HTML,把对应 Day 的 checkbox 打勾,进度自动保存。建议每集打勾时顺手存档到 Slot 1。

🎯 关键里程碑(庆祝点)

• M1 (Day 25): 平台层完成,屏幕上有会动的方框,热重载生效。
• M2 (Day 70): 完整可玩 2D 关卡,有怪物、攻击、投射物。
• M3 (Day 121): 🔥🔥🔥 SIMD 软渲染 tiled marathon 完成。
• M4 (Day 175): 字体能渲染,内存分配器完工。
• M5 (Day 234): Debug 系统完成,有自己的 profiler。
• M6 (Day 260): OpenGL 迁移完成。
• M7 (Day 435): 光照系统完工(此时已是 Handmade Hero 高手)。
• M8 (Day 575): 光探针完工,有 in-game 编辑器、世界生成器。
• M9 (Day 667): 🎉 全剧终——体素碰撞、k-d tree raycaster、octahedral 光照、实体存储简化收官。

⚠️ 风险与应对