Chapter 0 — 出发前的准备

预计时间：45 ~ 90 分钟
本章目标：确认 gcc、RISC-V 工具链、QEMU 和 lab 仓库都已经处于可继续推进的状态

正式课程会从下一章开始进入编译器本身，但在那之前，你得先把起跑线摆正。这里的“准备”不是为了多看一页导言，而是为了确保你后面每次读 chapter、做 lab、看到测试输出时，都知道自己到底在看什么、改什么、以及哪里出了问题。

做完这一章，你还不需要已经懂词法分析、AST 或 RISC-V 调用约定。你只需要进入一个很明确的工作状态：机器上的工具是通的，miniCompiler_lab 已经在本地，第一次 smoke test 已经跑过，接下来可以直接进入 Chapter 1。

0.1 课程网页和 lab 仓库分别干什么

先把两个角色分清楚，不然后面很容易改错地方。

也就是说，这门课的节奏是：先读 chapter，再进入 lab 仓库里对应的实验目录，补这一章该写的代码。你不需要在一个完整工程里到处找入口，当前 chapter 会告诉你应该进入哪个 labs/... 目录。

本章完成后，你应当同时满足下面四条：

最后一条尤其重要。因为这门课不是“下载一堆讲义，然后自己猜实践边界”，而是要求你从一份已经准备好的实验骨架出发，沿着章节逐步完成编译器。

请先在终端执行：

gcc --version
riscv64-unknown-linux-gnu-gcc --version
qemu-riscv32 --version

如果三条命令都能打印版本信息，说明你的基础环境已经够用了。

如果这里出现 command not found，先不要继续读后面的章节。优先把工具补齐：

sudo apt install gcc-riscv64-unknown-elf qemu-user

或者使用仓库 README 里给出的 Linux 发行版对应包名。

此刻你不需要深入研究交叉编译器内部怎么工作。先记住一件事：这门课的最终目标不是只在主机上打印一些调试信息，而是要把生成的 RISC-V 汇编交给工具链和 QEMU 真正跑起来。

课程网页负责讲解，lab 仓库负责让你写代码。现在打开一个你准备用来放实验的目录，执行：

git clone https://github.com/Luyoung0001/miniCompiler_lab.git
cd miniCompiler_lab

在 miniCompiler_lab 根目录执行：

pwd
ls

你应该至少能看到这些内容：

这里先不要急着把所有源文件都翻完。你现在真正需要建立的，只是一个非常粗的地图：

后面每章都会把这张粗地图收紧到当前这一章相关的 2~4 个文件上。

现在进入课程实践区，执行：

bash scripts/bootstrap-practice.sh

这个脚本会做三件事：

如果你想手动确认它最后做了什么，也可以自己继续执行：

cd labs/lab01-step1
make clean && make test

第一次进入 Lab01，你看到的通常不是全通过，而是若干个 [FAIL]。这并不意味着环境损坏，恰恰说明三件事已经成立：

这门课真正的出发点不是“你已经拥有一个完成的编译器”，而是“你已经进入一个可以逐章把它做出来的状态”。

如果这里没有跑到预期输出，先按这个顺序排查：

现象	先检查什么
`gcc: command not found`	主机编译器没有装好
`riscv64-unknown-linux-gnu-gcc: command not found`	交叉工具链没装好
`qemu-riscv32: command not found`	QEMU 用户态模拟器没装好
`No such file or directory`	当前目录是不是 `miniCompiler_lab` 仓库根目录
`make` 阶段失败	先看是编译错误、链接错误，还是验证程序报错

如果你只是第一次看到若干 [FAIL]，那不属于故障，不要在这里过度排错，直接进入下一章即可。

这一章没有让你开始写 lexer，也没有带你看文法规则。它只完成了一件更基础的事：把你准确送到正式课程入口。

现在你已经知道：

这就够了。真正的知识点，从下一章开始。

现在直接进入：