3. 快速上手：用默认配置编译一个最小系统

说实话，很多初学者学 Buildroot 最大的障碍，不是它有多难，而是卡在「第一步跑不起来」。你想想看，折腾半天编译出一个镜像，结果不知道往哪烧，或者烧了之后黑屏，那种挫败感我太熟悉了。

所以这一章，咱们直接来一个「最小闭环」。用 Buildroot 的默认配置，编译一个能在 QEMU 上跑的最小系统。你不需要任何开发板，一台电脑就够了。

3.1 为什么选 QEMU？

QEMU 是一个硬件模拟器。它能模拟出一台完整的 ARM、x86 或 RISC-V 机器。我个人的习惯是，在接触一个新板子之前，先用 QEMU 把 Buildroot 的流程跑通。原因很简单：QEMU 不会烧坏，也不会因为硬件问题让你怀疑人生。

咱们这次选的目标是 qemu_arm_versatile_defconfig。这是一个经典的 ARM 开发板模拟配置，资源占用小，编译快，非常适合入门。

我的建议： 第一次玩 Buildroot，别一上来就搞复杂的板子。先用 QEMU 把整个「配置 → 编译 → 运行」的链路走一遍，建立信心。

3.2 整体流程概览

在动手之前，我们先看看整个工作流长什么样。下面这张图，我每次给团队新人讲的时候都会画一遍。

Buildroot + QEMU 最小系统工作流 下载 Buildroot 选择 defconfig make 编译 生成镜像 QEMU 启动 登录系统 整个流程从下载到登录，熟练后 10 分钟内就能完成。第一次编译会慢一些，因为要下载工具链和源码包。

你看，步骤其实不多。核心就是四步：下载、选配置、编译、运行。咱们一步步来。

3.3 动手：从下载到运行

3.3.1 下载 Buildroot

我建议你直接用最新的长期支持版本。去 buildroot.org 下载，或者用 git 拉取。

# 方式一：下载 tar 包
wget https://buildroot.org/downloads/buildroot-2024.02.tar.gz
tar -xzf buildroot-2024.02.tar.gz
cd buildroot-2024.02/

# 方式二：git 克隆（我更喜欢这种方式，方便切换分支）
git clone git://git.buildroot.net/buildroot
cd buildroot/
git checkout 2024.02.x
注意： 不要用 root 用户编译！我曾经见过有人用 root 编译，结果权限混乱，整个工程都废了。建一个普通用户，或者用你自己的工作账号。

3.3.2 选择默认配置

Buildroot 自带了很多现成的配置，放在 configs/ 目录下。咱们这次用 QEMU ARM 的配置。

make qemu_arm_versatile_defconfig

这条命令会生成一个 .config 文件。你可以用 make menuconfig 看看里面都有什么，但第一次建议先别改，直接用默认的。

为什么会这样？因为默认配置已经帮你选好了内核版本、文件系统类型、根文件系统大小等关键参数。对于验证流程来说，完全够用。

3.3.3 编译

这一步最耗时，也最考验耐心。

make

第一次编译，Buildroot 会下载交叉编译工具链、Linux 内核源码、各种软件包。网速慢的话，可能要等 20-30 分钟。我自己的经验是，第一次编译时可以去泡杯咖啡，或者看看文档。

编译过程中，你会看到屏幕上刷刷地滚过各种信息。别慌，只要没有出现红色的 ERROR，就说明一切正常。

编译完成后，你会得到什么？

所有输出都在 output/images/ 目录下。对于我们的配置，关键文件是：

  • zImage — 压缩后的 Linux 内核镜像
  • versatile-pb.dtb — 设备树文件
  • rootfs.ext2 — 根文件系统镜像

3.3.4 用 QEMU 启动

编译完成后，Buildroot 会贴心地告诉你启动命令。你可以在终端输出里找到类似这样的信息：

# 这是 Buildroot 自动生成的启动脚本
qemu-system-arm -M versatilepb \
  -kernel output/images/zImage \
  -dtb output/images/versatile-pb.dtb \
  -drive file=output/images/rootfs.ext2,if=scsi,format=raw \
  -append "root=/dev/sda console=ttyAMA0,115200" \
  -nographic

直接复制粘贴到终端，回车。你会看到 QEMU 启动，Linux 内核开始打印启动信息。几秒钟后，就会出现登录提示。

...
Welcome to Buildroot
buildroot login: root
#

输入 root，不需要密码，直接回车。你就进入了这个最小系统的 shell。

一个小技巧： 退出 QEMU 的方法是 Ctrl+A 然后按 x。不是 Ctrl+C，也不是 Ctrl+D。我第一次用的时候按了半天 Ctrl+C，还以为死机了。

3.4 验证：这个系统里有什么？

登录进去之后，你可以随便逛逛。看看这个最小系统到底有多「小」。

# 查看根目录
ls /

# 查看内存信息
free -m

# 查看进程
ps

# 查看网络接口
ifconfig

你会发现，这个系统非常精简。没有图形界面，没有桌面环境，甚至连 apt-get 或 yum 都没有。但别小看它——它包含了 Linux 系统的核心骨架：内核、shell、基本的文件系统工具。

我记得第一次在 QEMU 上看到 # 提示符时，心里还是挺激动的。虽然只是一个模拟器，但整个工具链、内核、根文件系统都是自己编译出来的，那种掌控感是直接用发行版体会不到的。

3.5 常见问题与避坑

问题 原因 解决办法
编译时提示 command not found 缺少必要的系统工具，如 make、gcc、flex、bison 安装依赖：sudo apt install build-essential flex bison
下载源码包失败 网络问题，或者某些源码包被墙 配置代理，或者使用国内镜像源
QEMU 启动后黑屏 命令行参数写错了，或者内核/设备树不匹配 仔细检查 -kernel、-dtb、-drive 的路径
登录时提示 login: root: No such file or directory 根文件系统没有正确挂载 检查 -append 参数中的 root=/dev/sda 是否正确
我曾经踩过的坑： 有一次我编译完，怎么都启动不了。折腾了半天，发现是 QEMU 版本太旧，不支持设备树。所以建议你用较新的 QEMU 版本，至少 5.0 以上。

3.6 本章小结

到这里，你已经完成了 Buildroot 的第一次完整工作流。从下载、配置、编译到在 QEMU 上运行，整个链路都通了。

别看这只是个「最小系统」，它的意义在于：你亲手构建了一个完整的嵌入式 Linux 系统。后面所有的定制化、优化、添加软件包，都是在这个基础上展开的。

← 上一章 📖 返回目录 下一章 →