3. 开发环境搭建

RISC-V 开发环境的核心是一套“从源码到可运行镜像”的工具链。与 x86 本地编译不同，RISC-V 通常需要在 x86 主机上生成 RISC-V 目标代码，因此必须使用交叉工具链。理解工具链中每个组件的位置与职责，是后续编写汇编、链接脚本和启动代码的前提。

一、工具链组成与数据流

一条完整的 RISC-V 工具链通常包含编译器前端、汇编器、链接器、二进制工具和调试器。以 GNU 工具链为例，常见命令前缀为 riscv64-unknown-elf- 或 riscv64-linux-gnu-。前者面向裸机/嵌入式，后者面向 Linux 用户态。选择哪个前缀，取决于目标运行环境。

从源文件到可执行镜像，数据流大致如下：C 源文件经 gcc 编译为汇编，汇编器 as 将 .S 文件转为可重定位目标文件 .o，链接器 ld 按链接脚本把多个 .o 合并为 .elf，再用 objcopy 提取为 .bin 或 .hex，最后交给 QEMU 或真实硬件运行。调试器 gdb 通过 OpenOCD 或 QEMU 的 gdbstub 连接目标。

二、安装方式与工具链选择

安装 RISC-V 工具链有三条常见路径：使用发行版包管理器、下载官方预编译包、或从源码构建。对于课程实验，推荐使用预编译包，避免源码构建耗时过长。

# Ubuntu 安装（裸机工具链）
sudo apt install gcc-riscv64-unknown-elf binutils-riscv64-unknown-elf

# 或使用官方预编译包
wget https://github.com/riscv-collab/riscv-gnu-toolchain/releases/download/...
tar -xzf riscv64-unknown-elf-gcc-*.tar.gz -C /opt
export PATH=/opt/riscv/bin:$PATH

# 验证
riscv64-unknown-elf-gcc --version
riscv64-unknown-elf-as --version
riscv64-unknown-elf-ld --version

选择工具链时要注意 ABI 与架构字符串。常见组合为 -march=rv64imac -mabi=lp64 或 -march=rv32imac -mabi=ilp32。如果链接时出现 “can't link soft-float modules with double-float modules”，说明 ABI 不一致，需要统一 -mabi。

三、QEMU 配置与运行

QEMU 是 RISC-V 开发中最常用的模拟器，支持 qemu-system-riscv64 和 qemu-system-riscv32。它可以直接加载 ELF 或 bin 文件，并模拟串口、定时器、中断控制器等外设。典型启动命令如下：

qemu-system-riscv64 \
  -machine virt \
  -nographic \
  -bios none \
  -kernel build/hello.elf \
  -s -S

其中 -machine virt 指定虚拟平台，-nographic 将串口输出到终端，-bios none 表示不加载默认固件，-kernel 加载我们的镜像，-s -S 开启 gdbstub 并暂停等待调试器连接。连接 GDB 的命令为：

riscv64-unknown-elf-gdb build/hello.elf
(gdb) target remote :1234
(gdb) break _start
(gdb) continue

四、常见误区与排查清单