这张路线适合谁
前置要求一句话说死：有任意一门语言的实操经验即可——C/C++ 背景走得最快（内存与指针的心智直接复用），Go/Rust 背景有大量可对照的概念（错误处理、显式转换），纯动态语言背景也不怕，路线里把内存这块补上；完全没写过代码的请先去走站内某门语言的从零路线（比如 Go 系列的环境搭建起步的那条），再回来。也要说不适合谁：需要 1.0 稳定承诺、生态厚度或岗位保底来支撑投入的，Zig 现阶段给不了，判断依据见开山篇的三条风险。这条路线的终点不是”精通 Zig”，而是”能用 Zig 完成小型工具项目，并跟得上它的版本演进”。时长口径：每天 1-2 小时业余学习，全程约 6-8 周。
总览
| 阶段 | 目标 | 阶段产出 | 预估时长 |
|---|---|---|---|
| 0 判断与观察 | 决定值不值得投入，环境就绪 | hello world 跑通 + 一段自己的判断记录 | 3-5 天 |
| 1 工具链地基 | zig run/build/test/fmt/cc 成体系 | build.zig 项目 + zig cc 交叉编译两个平台的 C 产物 | 1 周 |
| 2 语言核心 | 错误集、可空、tagged union、comptime 初见 | 一个带 pop/peek 的泛型 Stack 加测试 | 1.5-2 周 |
| 3 内存与分配器 | 四种内置分配器的心智与选型 | DebugAllocator 下零泄漏的行统计器 | 1.5 周 |
| 4 错误处理与测试纪律 | 错误集分层 + 失败路径全测试 | 坏输入有测试覆盖的解析器 | 1 周 |
| 5 实战整合 | 把前三阶段拼进一个真实 CLI | TODO CLI 复跑 + 自己扩展一个命令 | 1 周 |
| 6 跟版本演进 | 把”版本变动”当成学习内容本身 | 实战代码迁到 0.15.1 编译通过的迁移笔记 | 持续 |
阶段 0：判断与观察（3-5 天）
学什么：先读开山篇把定位、安装与三条 pre-1.0 风险过一遍，再亲手装一个 0.14.1 环境跑 hello world。投入决策看两样：有没有”替换手写 C、写性能敏感小工具”的真实需求，以及能不能接受教程与版本错位的学习摩擦。资源只用官方：ziglang.org 的下载页与 Getting Started，不装第三方教程先行。产出与验收：zig version 与 hello world 都正常，并写一段三行的自我判断（为什么学、预期用途、可接受的风险）。常见卡点：Linux 发行版源里的 Zig 版本严重滞后——官网压缩包解压即用，别用 apt。
阶段 1：工具链地基（1 周）
学什么：六个命令成体系——zig run（脚本级验证）、zig init/build（项目与 build.zig）、zig build test、zig fmt（无配置的官方格式化）、zig cc（把 Zig 当跨平台 C 编译器）。不熟命令行的先补一遍站内Linux 常用命令。产出与验收：zig init 建项目跑通 hello；再用 zig cc 把一段 C 代码交叉编译出两个平台的产物——这是 Zig 工具链最被低估的即战力，本机不装任何交叉工具链就能做，值得第一周就体验：
# 同一份 hello.c，两条命令出两个平台的可执行文件
zig cc -target x86_64-windows-gnu hello.c -o hello.exe
zig cc -target x86_64-linux-gnu hello.c -o hello
file hello.exe hello # PE 与 ELF 各一份，交叉工具链是 Zig 自带的常见卡点：build.zig 是 DSL，第一周看不懂是正常的，先当黑盒用固定模板，阶段 6 回头补。
阶段 2：语言核心（1.5-2 周）
学什么：主线是《Zig 语法要点》——变量与编译期已知值、溢出语义选运算符、表达式化控制流、错误集与 try/catch/errdefer、可空三出口、tagged union、comptime 泛型初见。练手用 ziglings（官方 learn 页面推荐的”修坏程序学语法”练习集，注意 checkout 与你工具链匹配的版本分支），每天 3-5 题正合适。产出与验收：把语法篇的 Stack 骨架补全 pop/peek 与溢出错误，配上三条测试用 zig build test 跑绿；能口头回答”comptime 参数和运行时参数差在哪”。常见卡点：网上教程编译不过——先对版本再对代码，教程是 0.10 的就 checkout 0.10 时代的练习分支，别硬改。
阶段 3：内存与分配器（1.5 周）
学什么：《Zig 基础知识参考字典》的分配器组逐条跑——alloc/free/dupe 的所有权约定、Arena 的整批结账、DebugAllocator 的泄漏检查、page 与 smp 的适用边界；配套读官方 std.heap 文档。这是 Zig 区别于 GC 语言的核心训练，跳过它等于白学。产出与验收：写一个读文本文件、按行统计并打印的小程序，用 ArenaAllocator 写一版、用 DebugAllocator 写一版，后者跑完 deinit 无泄漏报告；能说清”什么时候 arena 是错的”（长驻服务热路径）。常见卡点：悬垂切片——返回指向局部数组的切片编译器不拦，养成”切片指向谁的缓冲区、它活多久”的口头检查习惯。
阶段 4：错误处理与测试纪律（1 周）
学什么：字典的错误与可空组、测试组——try/catch/errdefer 的分工、错误集怎么当 API 契约、test 块与 refAllDecls。产出与验收：把阶段 3 的统计器错误路径化——文件不存在、坏行、空文件各有语义与测试，坏输入的用例用 expectError 断言指定错误。Go 背景的把Go 错误处理翻出来对照：错误集进签名 vs error 接口值，两派的取舍在亲手写一遍后才算真懂。常见卡点：浮点断言用 expectEqual 直接崩——用 expectApproxEqAbs。
阶段 5：实战整合（1 周）
学什么：完整复跑《用 Zig 写一个 TODO CLI》——它就是阶段 2-4 三个主题的整合体，分配器策略、错误集分层、边界语义转换全在里面。产出与验收：复跑跑通验收表，然后自己扩展一个命令（建议 done-all 全部打勾，或 export 导出 Markdown），照着既有代码的风格加解析、加测试；扩展命令跑通且测试绿才算过。常见卡点：扩展时发现”每个命令都要 save 一次”很啰嗦——先忍住，等写过两三个命令再重构，别第一天就抽象。
阶段 6：跟版本演进（持续）
学什么：把版本演进本身当学习内容。第一个完整案例就是 0.15.1（2025-08-20 发布）：Writergate 的 std.Io 读写接口重构、ArrayList 默认改 unmanaged、std.process.args 去掉分配器参数——把阶段 5 的 TODO CLI 迁到 0.15.1 编译通过，迁移过程写成笔记，这就是最真实的”读 release notes”训练。之后每季度花半天看一次官方 release notes；async 的重新设计值得跟踪但不要押注（自 0.11 移除后仍未回归，回归形式未定）。产出与验收：一份迁移笔记，能列出”哪些 API 变了、为什么变、官方迁移建议是什么”。常见卡点：搜到的答案互相矛盾——按日期排，晚于 2025-08-20 的答案才可能适用于 0.15。
避坑清单
| 不要 | 代价 |
|---|---|
| 不要拿旧教程硬配新编译器 | 版本错位是 Zig 学习第一大坑：把”版本差异”误判成”自己学不会”，直接劝退 |
| 不要跳过分配器直接抄能跑的代码 | 错过这门语言的核心训练；写多生命周期程序时欠的账全部连本带利还回来 |
| 不要背 API | 0.15 一个版本就改了 ArrayList 与整套 IO——记”去官方文档哪查”比记”现在是什么”保值 |
| 不要把生产关键路径押上 pre-1.0 | 语法未冻结、async 搁置、生态与岗位都小——公司核心业务请留在成熟语言观望 |
| 不要用 C 的直觉写控制流和错误兜底 | else-if 瀑布代替 switch 穷尽、catch unreachable 当默认兜底，等于把编译器请来的保安亲手送走 |
学完之后
走完六个阶段，你手里有一个自己扩展过的 CLI、一份迁移笔记和一套”对版本再对代码”的检索习惯。下一步的三个方向：要更深，去读以 Zig 为底座的真实项目源码（Bun、TigerBeetle 都开源且体量适中）；要横向比较”新语言在 1.0 前怎么长大”，站内有同代的两条路线可对照——Mojo 学习路线（性能工程视角）与Elixir 学习路线（成熟 BEAM 生态视角）；要回头补功课，阶段 1 的命令行常识与 Go 系列的从零路线都在站内。最后保持诚实：pre-1.0 的正确姿态是观察者加练手者，等 1.0 时间表、async 落地、生态岗位三个信号里的两个出现，再把生产投入提上日程。
版本核实（以官方文档为准）：路线全程锚定 2025-08-25 至 09-04 的时点——0.14.1（2025-05-23）与 0.15.1（2025-08-20，0.15.0 被取消）为该窗口内的稳定版，0.15.2 尚未发布；0.14.0（2025-03-05）起 GPA 改名 DebugAllocator 并新增 smp_allocator；async/await 自 0.11（2023）移除后截至本文仍处搁置状态，0.15 的 IO 重构为其重新设计铺路但未恢复语言级 async；ziglings 为官方 learn 页面推荐的练习项目，按版本分支维护；文中未引用任何尚未发布版本的行为。