2. QEMU模拟器深度安装与配置

2.1 为什么选择源码编译QEMU

大多数Linux发行版通过包管理器提供的QEMU版本往往滞后，且默认编译选项仅包含少数目标架构。对于内核调试场景，我们需要精确控制QEMU的版本、补丁以及启用的架构支持。源码编译是获得最佳调试体验的必经之路。

2.2 安装必要依赖包

在开始编译之前，需要安装构建工具链和QEMU所需的库。以下以Ubuntu 22.04 LTS为例，其他发行版请使用对应的包管理器。

# 一键安装所有依赖（Ubuntu/Debian）
sudo apt update
sudo apt install -y build-essential git pkg-config \
    libsdl2-dev libspice-server-dev libvirglrenderer-dev \
    libvdeplug-dev libslirp-dev libcap-ng-dev libaio-dev \
    python3 python3-sphinx ninja-build \
    libglib2.0-dev libpixman-1-dev libzstd-dev

2.3 下载QEMU源码与版本选择

QEMU官方发布版本可从 https://download.qemu.org/ 获取。对于内核调试课程，推荐使用 QEMU 8.2.x 或 9.0.x 稳定版，它们对RISC-V和ARMv8.4的模拟支持最为完善。

# 下载QEMU 9.0.0源码
wget https://download.qemu.org/qemu-9.0.0.tar.xz
tar -xf qemu-9.0.0.tar.xz
cd qemu-9.0.0

2.4 配置与编译：支持x86_64/ARM/RISC-V

QEMU使用Meson构建系统。配置阶段通过 --target-list 参数精确控制需要编译的架构。以下配置同时启用三种主流架构的软模拟（TCG）和硬件加速（KVM）支持。

# 创建构建目录（保持源码目录干净）
mkdir build && cd build

# 配置命令（关键参数说明见下方表格）
../configure \
    --target-list="x86_64-softmmu,aarch64-softmmu,riscv64-softmmu" \
    --enable-kvm \
    --enable-sdl \
    --enable-spice \
    --enable-slirp \
    --enable-virglrenderer \
    --enable-debug \
    --enable-debug-info \
    --enable-gdb \
    --enable-tcg-interpreter \
    --enable-virtfs \
    --enable-linux-aio \
    --enable-cap-ng \
    --enable-vde \
    --enable-zstd

# 编译（使用 -j 参数利用多核加速）
make -j$(nproc)

# 安装到系统路径（可选，建议使用自定义路径避免污染系统）
sudo make install

# 或者安装到自定义目录（推荐）
make install DESTDIR=/opt/qemu-9.0.0

2.5 QEMU源码编译流程SVG架构图

2.6 验证QEMU版本与功能

安装完成后，通过以下命令验证各架构模拟器是否正常工作，并确认关键调试特性已启用。

# 查看QEMU版本
qemu-system-x86_64 --version
# 输出示例：QEMU emulator version 9.0.0 (v9.0.0)

# 查看编译时启用的特性
qemu-system-x86_64 -M help | head -20
# 输出示例：Supported machines（列出所有支持的机器类型）

# 验证GDB stub支持（关键调试功能）
qemu-system-x86_64 -s -S -M help 2>&1 | grep -i "gdb"
# 如果输出包含 "gdb" 或 "stub"，表示GDB调试支持已启用

# 验证KVM加速支持
qemu-system-x86_64 -accel help
# 输出示例：kvm, tcg（表示KVM和TCG都可用）

# 验证各架构模拟器是否存在
for arch in x86_64 aarch64 riscv64; do
    echo "=== qemu-system-${arch} ==="
    qemu-system-${arch} --version 2>/dev/null || echo "未安装"
done

2.7 功能验证清单

2.8 常见编译问题与解决方案

2.9 配置自定义安装路径与PATH设置

为避免与系统包管理器安装的QEMU冲突，建议将QEMU安装到自定义目录，并将该目录加入 PATH 环境变量。

# 安装到 /opt/qemu-9.0.0
make install DESTDIR=/opt/qemu-9.0.0

# 将QEMU二进制路径加入 ~/.bashrc 或 ~/.zshrc
echo 'export PATH=/opt/qemu-9.0.0/usr/local/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 验证自定义路径生效
which qemu-system-x86_64
# 输出：/opt/qemu-9.0.0/usr/local/bin/qemu-system-x86_64

2.10 本章小结