1. 课程导入
做嵌入式开发这么多年，我越来越觉得，一个好的调试环境能省下一半的排错时间。QEMU 配合 RISC-V，说白了就是让你在没拿到真实芯片之前，先把软件跑起来、把问题揪出来。这一章，咱们先把地基打牢。
1.1 QEMU 是什么？
QEMU 是一个开源的机器模拟器。它能模拟整个硬件平台——CPU、内存、外设，甚至网络。你可以在你的 PC 上跑一个完整的嵌入式系统，就像操作真实开发板一样。
我个人习惯把 QEMU 分成两类用法：
- 系统级模拟（System Mode）：模拟整机，可以启动操作系统。我们这门课主要用这种。
- 用户态模拟（User Mode）：只模拟 CPU，直接运行单个二进制文件。适合快速测试算法。
核心观点：QEMU 不是玩具。我在一个物联网项目中，芯片样片还没回来，就用 QEMU 把整个协议栈调通了。等板子到手，基本一次点亮。
1.2 RISC-V 架构速览
RISC-V 是个精简指令集架构。它最大的特点是——开放、模块化。你不需要给任何人交授权费，想怎么用就怎么用。
它的指令集分几个层级：
| 指令集 | 全称 | 说明 |
|---|---|---|
| RV32I / RV64I | 基础整数指令集 | 必须实现，包含加减、跳转、访存等 |
| M 扩展 | 乘除法扩展 | 硬件乘除法指令 |
| A 扩展 | 原子操作扩展 | 多核同步必备 |
| F / D 扩展 | 单/双精度浮点 | 浮点运算 |
| C 扩展 | 压缩指令扩展 | 16位指令，减小代码体积 |
嗯，这里要注意：QEMU 默认支持 RV64GC，也就是基础 64 位 + 整数乘除 + 原子 + 浮点 + 压缩。大部分场景够用了。
1.3 从源码编译 QEMU
我建议你从源码编译。为什么？因为发行版自带的 QEMU 版本往往偏旧，而且可能没开启 RISC-V 支持。自己编译，心里有底。
步骤如下：
- 下载源码：从
https://download.qemu.org/获取最新稳定版。 - 安装依赖：
sudo apt-get install build-essential pkg-config
sudo apt-get install libglib2.0-dev libpixman-1-dev
sudo apt-get install ninja-build- 配置编译：
./configure --target-list=riscv64-softmmu --enable-debug
make -j$(nproc)
sudo make install我的经验：--enable-debug 这个选项一定要加。它会让 QEMU 输出更多调试信息，后面分析日志时你会感谢这个决定的。
编译大概需要 10-20 分钟，取决于你的机器。趁这个时间，你可以泡杯茶，想想你的项目架构。
1.4 配置 RISC-V 系统级模拟器
编译完成后，验证一下：
qemu-system-riscv64 --version能看到版本号，说明安装成功。接下来，我们需要一个启动用的固件和内核。我推荐用 OpenSBI + Linux 内核的组合。
快速启动命令示例：
qemu-system-riscv64 \
-machine virt \
-m 2G \
-smp 4 \
-kernel fw_jump.bin \
-device loader,file=Image,addr=0x80200000 \
-append "root=/dev/vda ro" \
-drive file=rootfs.ext4,format=raw,id=hd0 \
-device virtio-blk-device,drive=hd0 \
-nographic我来解释一下关键参数：
-machine virt：使用 QEMU 自带的 RISC-V 虚拟平台。这个平台模拟了中断控制器、UART、PCIe 等常用外设。-m 2G：分配 2GB 内存。调试时够用了。-smp 4：模拟 4 个 CPU 核心。多核调试时很有用。-nographic：不使用图形界面，所有输出走串口。我习惯这样，方便复制日志。
避坑指南：我曾经在 -device loader 的地址上栽过跟头。RISC-V Linux 内核的加载地址通常是 0x80200000，但不同固件可能有差异。如果你发现内核没启动，先检查这个地址对不对。
1.5 本章知识结构
下面这张图，把本章的核心脉络串起来了。你可以把它当作一个快速索引。
1.6 验证环境
环境搭好之后，跑一个简单的 Hello World 来验证。你可以在 QEMU 里启动 Linux，然后执行：
echo "Hello from QEMU RISC-V!" > /dev/console如果串口输出了这行字，恭喜你，环境搭建成功。你想想看，从源码编译到系统启动，每一步都是你自己控制的。这种感觉，比用现成的二进制包踏实多了。
小技巧：把 QEMU 的启动命令写成一个 shell 脚本，比如 run_qemu.sh。后面调试时，你只需要改参数，不用每次都敲一长串命令。
嗯，环境搭好了，后面的事情就好办了。调试、日志分析、故障定位，都建立在这个基础上。咱们一步一步来。