2. QEMU源码编译与安装：从源码获取、配置选项详解、编译流程、安装与验证

从源码编译QEMU是深入理解其内部机制的最佳途径。本章将完整演示从源码获取、关键配置选项解析、编译流程到最终安装验证的全过程，帮助读者建立从源码到可执行文件的完整认知。

2.1 源码获取与版本选择

QEMU官方源码托管于GitLab仓库，同时提供稳定版tar包。推荐使用Git克隆以获得完整的版本历史和分支切换能力。

版本选择建议： 生产环境建议使用最新稳定版（如8.x或9.x），开发调试可使用master分支。本课程基于QEMU 8.2.0 LTS版本进行演示。

2.1.1 获取方式对比

方式 命令/链接 适用场景 大小
Git克隆 git clone https://gitlab.com/qemu-project/qemu.git 开发、调试、跟踪最新代码 ~500MB（含历史）
tar包下载 wget https://download.qemu.org/qemu-8.2.0.tar.xz 快速部署、生产环境 ~40MB
发行版源码包 apt-get source qemu 与系统包管理集成 ~50MB

2.1.2 源码目录结构概览

克隆或解压后的QEMU源码根目录包含以下核心子目录：

  • hw/ — 硬件模拟代码，按架构和总线组织（如hw/arm/、hw/pci/）
  • target/ — 目标CPU架构翻译代码（如target/arm/、target/riscv/）
  • accel/ — 加速器后端（TCG、KVM、HVF、WHPX）
  • softmmu/ — 系统级模拟主循环和内存管理
  • block/ — 块设备驱动和I/O后端
  • net/ — 网络后端（tap、user、vde等）
  • chardev/ — 字符设备后端
  • migration/ — 迁移和快照功能
  • ui/ — 用户界面（SDL、GTK、VNC、SPICE）
  • pc-bios/ — 预编译BIOS和固件镜像
QEMU 源码目录结构（核心模块） qemu/ (源码根目录) hw/ 硬件模拟 target/ CPU翻译 accel/ 加速器 softmmu/ 系统模拟 block/ 块设备 arm/ x86/ riscv/ ... arm/ i386/ riscv/ ... tcg/ kvm/ hvf/ whpx main-loop/ memory/ qcow2/ raw/ nbd net/ 网络后端 chardev/ 字符设备 migration/ 迁移 ui/ 用户界面 pc-bios/ 固件 关键说明 • hw/ 和 target/ 是架构相关代码的核心 • accel/ 决定使用TCG解释执行还是KVM硬件加速 • pc-bios/ 包含启动所需的BIOS/EFI固件

2.2 配置选项详解

QEMU使用GNU Autotools构建系统，通过configure脚本进行编译前配置。配置选项决定了编译哪些目标架构、启用哪些功能模块以及依赖库的链接方式。

2.2.1 核心配置选项分类

分类 选项示例 说明 推荐值
目标架构 --target-list=arm-softmmu,aarch64-softmmu 指定编译哪些架构的系统级模拟器 按需选择，减少编译时间
安装路径 --prefix=/opt/qemu 指定安装目录，默认/usr/local 建议自定义路径便于管理
加速器支持 --enable-kvm / --disable-kvm 启用或禁用KVM硬件加速支持 Linux主机建议启用
用户界面 --enable-gtk / --enable-sdl 启用图形界面显示后端 无头环境可禁用
块设备 --enable-qcow1 / --enable-vmdk 启用特定磁盘镜像格式支持 建议全部启用
调试与优化 --enable-debug / --enable-debug-info 启用调试符号和断言 开发调试时启用
依赖库 --enable-slirp / --enable-fdt 启用用户态网络栈和设备树支持 建议启用

2.2.2 典型配置场景

场景一：最小化快速编译（仅ARM系统模拟） 
./configure \
  --target-list=arm-softmmu,aarch64-softmmu \
  --disable-werror \
  --disable-gtk \
  --disable-sdl \
  --enable-debug \
  --prefix=/opt/qemu-arm
场景二：全功能生产编译（x86主机+多架构支持） 
./configure \
  --target-list="x86_64-softmmu,aarch64-softmmu,arm-softmmu,riscv64-softmmu" \
  --enable-kvm \
  --enable-virtfs \
  --enable-slirp \
  --enable-fdt \
  --enable-gtk \
  --enable-spice \
  --enable-usb-redir \
  --prefix=/opt/qemu-full

2.2.3 配置选项速查表

选项 默认值 作用
--target-list 全部架构 指定编译的目标列表，格式为arch-softmmu或arch-linux-user
--enable-kvm auto 启用KVM加速（仅Linux x86/ARM主机）
--enable-debug no 启用调试断言和额外检查
--enable-debug-info no 生成DWARF调试符号
--enable-slirp auto 启用用户态网络栈（无需root权限）
--enable-fdt auto 启用设备树（Flattened Device Tree）支持
--enable-virtfs auto 启用9p virtio文件系统共享
--disable-werror no 将警告视为错误（建议开发时禁用）
--static no 静态编译（生成独立可执行文件）

2.3 编译流程

QEMU的编译流程分为配置、构建和安装三个阶段。以下为完整的编译命令序列：

# 阶段一：配置
./configure \
  --target-list=arm-softmmu,aarch64-softmmu \
  --enable-debug \
  --enable-debug-info \
  --enable-slirp \
  --enable-fdt \
  --prefix=/opt/qemu

# 阶段二：编译（使用多核加速）
make -j$(nproc)

# 阶段三：安装
sudo make install
编译加速技巧： 使用 make -j$(nproc) 自动检测CPU核心数并行编译。对于大型项目，首次编译建议先 make -j1 确保无错误，后续增量编译使用多核。

2.3.1 编译产物说明

编译完成后，在源码目录的build/子目录（或根目录，取决于配置）中生成以下关键文件：

文件 说明 大小（参考）
qemu-system-arm ARM系统级模拟器可执行文件 ~15MB
qemu-system-aarch64 AArch64系统级模拟器可执行文件 ~16MB
qemu-img 磁盘镜像管理工具 ~2MB
qemu-io 块设备I/O调试工具 ~1MB
qemu-nbd 网络块设备导出工具 ~1MB
pc-bios/ 预编译固件和BIOS文件 ~10MB

2.3.2 常见编译错误及解决

错误信息 原因 解决方案
ERROR: glib-2.56 gthread-2.0 is required 缺少GLib库 sudo apt install libglib2.0-dev
ERROR: pixman >= 0.21.8 required 缺少pixman库 sudo apt install libpixman-1-dev
ERROR: slirp not found 缺少libslirp sudo apt install libslirp-dev
ERROR: fdt not found 缺少libfdt sudo apt install libfdt-dev
undefined reference to `qemu_...' 链接错误，通常为依赖缺失 检查config-host.mak中缺失的库

2.4 安装与验证

2.4.1 安装后目录结构

执行make install后，安装目录（如/opt/qemu）的结构如下：

/opt/qemu/
├── bin/
│   ├── qemu-system-arm
│   ├── qemu-system-aarch64
│   ├── qemu-img
│   ├── qemu-io
│   ├── qemu-nbd
│   └── qemu-storage-daemon
├── libexec/
│   └── qemu-bridge-helper
├── share/
│   ├── qemu/
│   │   ├── bios-256k.bin
│   │   ├── edk2-arm-code.fd
│   │   ├── edk2-aarch64-code.fd
│   │   ├── keymaps/
│   │   └── ...
│   └── man/
│       └── man1/
│           ├── qemu-system-arm.1
│           └── qemu-img.1
└── var/
    └── run/

2.4.2 验证安装

安装完成后，通过以下步骤验证QEMU是否正常工作：

  1. 检查可执行文件版本：
/opt/qemu/bin/qemu-system-arm --version
# 输出示例：
# QEMU emulator version 8.2.0
# Copyright (c) 2003-2023 Fabrice Bellard and the QEMU Project developers
  1. 列出支持的机器类型：
/opt/qemu/bin/qemu-system-arm -M help | head -20
# 输出示例（部分）：
# Supported machines are:
# akita                Sharp SL-C1000 (Akita) PDA (PXA270)
# ast2500-evb          ASPEED AST2500 EVB (ARM1176JZF-S)
# ast2600-evb          ASPEED AST2600 EVB (Cortex-A35)
# canon-a1100          Canon PowerShot A1100 IS
# cheetah              Palm Tungsten|E (OMAP310)
# collie               Sharp SL-5500 (Collie) PDA (SA-1110)
# connex               Gumstix Connex (PXA255)
# ...
  1. 测试最小启动（无磁盘）：
/opt/qemu/bin/qemu-system-arm \
  -M virt \
  -cpu cortex-a15 \
  -m 256M \
  -nographic \
  -kernel /dev/null \
  -append "console=ttyAMA0" \
  -serial mon:stdio

# 应能看到QEMU启动输出，最终因缺少根文件系统而挂起
注意： 如果出现 qemu-system-arm: command not found，请确保安装路径已添加到 PATH 环境变量，或使用完整路径执行。

2.4.3 环境变量配置

为方便使用，建议将QEMU安装路径添加到环境变量中：

# 编辑 ~/.bashrc 或 ~/.zshrc
export QEMU_HOME=/opt/qemu
export PATH=$QEMU_HOME/bin:$PATH
export MANPATH=$QEMU_HOME/share/man:$MANPATH

# 使配置生效
source ~/.bashrc

2.5 编译配置与安装流程总览

QEMU 源码编译与安装完整流程 阶段一：源码获取 Git 克隆或 tar 包下载 选择版本（稳定版/master） 阶段二：配置 (configure) --target-list 目标架构 --enable-kvm 加速器 --prefix 安装路径 --enable-debug 调试 阶段三：编译 (make) make -j$(nproc) 并行编译 生成 qemu-system-* 可执行文件 阶段四：安装与验证 sudo make install --version 版本验证 -M help 机器类型验证

2.6 本章小结

通过本章的学习，读者应掌握以下核心技能：

  • 源码获取： 理解Git克隆与tar包下载的适用场景，熟悉QEMU源码目录结构
  • 配置选项： 掌握--target-list、--enable-kvm、--prefix等关键配置参数的含义和用法
  • 编译流程： 熟练执行configure → make → make install三阶段编译安装
  • 安装验证： 通过--version、-M help和最小启动测试验证安装正确性
← 上一章 📖 返回目录 下一章 →