2. 开发环境搭建：RISC-V工具链安装、QEMU模拟器配置、源码获取与目录结构

在进行 xv6 内核的 RISC-V 移植适配之前，必须搭建一套完整、可复现的开发环境。本章将指导你完成 RISC-V 交叉编译工具链的安装、QEMU 模拟器的配置、xv6 源码的获取以及理解其核心目录结构。一个稳定的开发环境是后续所有内核实验与移植工作的基础。

2.1 RISC-V 交叉编译工具链安装

xv6 运行在 RISC-V 64-bit (RV64) 架构上，而你的开发主机通常是 x86_64 架构。因此，我们需要一套 交叉编译工具链，它能在 x86 主机上编译出可在 RISC-V 目标机上执行的二进制代码。核心组件包括：

• riscv64-unknown-elf-gcc：C 语言交叉编译器。
• riscv64-unknown-elf-binutils：汇编器、链接器（ld）、目标文件工具（objdump、objcopy）等。
• riscv64-unknown-elf-gdb：交叉调试器（可选，但强烈推荐）。

2.1.1 方案一：使用包管理器安装（快速，推荐）

对于大多数开发者，这是最快捷的方式。Ubuntu/Debian 的官方源或第三方 PPA 提供了预编译的 RISC-V 工具链。

# 更新包列表
sudo apt update

# 安装 RISC-V 交叉编译工具链（包含 gcc, binutils, gdb）
sudo apt install gcc-riscv64-linux-gnu binutils-riscv64-linux-gnu gdb-multiarch

# 验证安装
riscv64-linux-gnu-gcc --version
riscv64-linux-gnu-objdump --version

2.1.2 方案二：源码编译安装（定制化）

如果你需要最新的特性或特定的优化选项，可以从 RISC-V GNU Toolchain 官方仓库编译。此过程耗时较长（约 1-2 小时），但能获得完全可控的工具链。

# 1. 安装依赖
sudo apt install autoconf automake autotools-dev curl python3 python3-pip \
                 libmpc-dev libmpfr-dev libgmp-dev gawk build-essential \
                 bison flex texinfo gperf libtool patchutils bc \
                 zlib1g-dev libexpat-dev ninja-build

# 2. 克隆官方工具链仓库
git clone https://github.com/riscv-collab/riscv-gnu-toolchain.git
cd riscv-gnu-toolchain

# 3. 配置并编译裸机工具链（Newlib）
./configure --prefix=/opt/riscv --with-arch=rv64gc --with-abi=lp64d
sudo make -j$(nproc)

# 4. 将工具链加入 PATH
echo 'export PATH=$PATH:/opt/riscv/bin' >> ~/.bashrc
source ~/.bashrc

# 5. 验证
riscv64-unknown-elf-gcc --version

2.1.3 工具链验证

安装完成后，编写一个简单的 C 程序并交叉编译，验证工具链是否正常工作。

// test.c
int add(int a, int b) {
    return a + b;
}

int main() {
    int result = add(1, 2);
    return result;
}

# 使用包管理器安装的工具链
riscv64-linux-gnu-gcc -o test test.c -static

# 查看生成文件的架构
file test
# 输出应包含：ELF 64-bit LSB executable, UCB RISC-V, RVC, double-float ABI

# 使用 QEMU 用户态运行（需安装 qemu-user）
qemu-riscv64-static ./test
echo $?  # 应输出 3

2.2 QEMU 模拟器配置

QEMU 是一个强大的开源模拟器，能够模拟完整的 RISC-V 硬件平台（包括 CPU、内存、中断控制器、UART 等）。在开发初期，我们使用 QEMU 作为 xv6 的运行目标，无需物理开发板即可进行内核调试。

2.2.1 安装 QEMU

推荐从源码编译 QEMU，以确保支持最新的 RISC-V 特性（如 AIA 中断控制器）。

# 1. 安装 QEMU 编译依赖
sudo apt install build-essential pkg-config zlib1g-dev libglib2.0-dev \
                 libpixman-1-dev libslirp-dev

# 2. 下载 QEMU 源码（以 v8.2.0 为例）
wget https://download.qemu.org/qemu-8.2.0.tar.xz
tar -xf qemu-8.2.0.tar.xz
cd qemu-8.2.0

# 3. 配置，仅编译 RISC-V 系统模拟器
./configure --target-list=riscv64-softmmu --prefix=/opt/qemu --enable-slirp

# 4. 编译并安装
make -j$(nproc)
sudo make install

# 5. 将 QEMU 加入 PATH
echo 'export PATH=$PATH:/opt/qemu/bin' >> ~/.bashrc
source ~/.bashrc

# 6. 验证
qemu-system-riscv64 --version

2.2.2 QEMU 启动参数解析

启动 xv6 时，QEMU 需要指定机器类型、CPU 核心数、内存大小、设备树以及内核镜像。下表列出了 xv6 移植中最常用的 QEMU 参数：

2.2.3 启动脚本示例

为了方便，通常将 QEMU 启动命令封装在 Makefile 或独立的 Shell 脚本中。以下是 xv6 标准 Makefile 中 QEMU 启动目标的简化版本：

# 在 xv6 根目录下执行
# 使用 QEMU 启动 xv6（单核，无图形界面）
qemu-system-riscv64 \
    -machine virt \
    -cpu rv64 \
    -smp 1 \
    -m 128M \
    -kernel kernel/kernel \
    -nographic \
    -serial mon:stdio \
    -bios none

2.3 源码获取与目录结构

xv6 的官方源码托管在 MIT 的 GitHub 仓库中。我们获取的是 xv6-riscv 分支，这是专门为 RISC-V 架构重写的版本。

2.3.1 获取源码

# 克隆官方仓库
git clone https://github.com/mit-pdos/xv6-riscv.git
cd xv6-riscv

# 查看当前分支（应为 riscv）
git branch

# 可选：切换到特定版本标签，以保持与课程一致
# git checkout tags/2023

2.3.2 目录结构总览

xv6 的源码组织非常紧凑，全部位于根目录下，没有复杂的子目录嵌套。这种扁平化结构便于初学者理解内核的全貌。下图展示了核心文件及其功能分组：

2.3.3 关键文件说明

下表列出了 xv6 源码中最重要的文件及其在移植适配中的角色：

2.4 环境验证与首次编译

完成上述步骤后，我们通过编译 xv6 并运行在 QEMU 上来验证整个开发环境是否搭建成功。

# 进入 xv6 源码目录
cd xv6-riscv

# 清理之前的编译产物（如果是首次编译可跳过）
make clean

# 编译内核和用户态程序
# 注意：如果使用包管理器安装的工具链，可能需要修改 Makefile 中的 TOOLPREFIX
# 将 TOOLPREFIX = riscv64-unknown-elf- 改为 TOOLPREFIX = riscv64-linux-gnu-
make -j$(nproc)

# 如果编译成功，会在 kernel/ 目录下生成 kernel ELF 文件
# 在 user/ 目录下生成 _sh, _cat, _ls 等用户程序

# 使用 QEMU 启动 xv6
make qemu

如果一切顺利，你将看到 QEMU 窗口（或终端）中输出 xv6 的启动信息，并最终出现 $ 提示符，表示 xv6 的 Shell 正在运行。你可以输入 ls 命令来列出文件。