2、环境搭建：在Ubuntu 22.04上安装Buildroot依赖、下载Buildroot源码、首次编译前的准备

好，咱们正式开始动手了。这一章说白了就是「磨刀不误砍柴工」。你想想看，如果环境没搭好，后面编译到一半报个错，那才叫崩溃。我当年刚接触Buildroot时，就吃过这个亏——依赖没装全，编译到90%突然挂了，查了半天才发现少了个库。嗯，咱们今天就把这事一次性搞定。

2.1 为什么选择Ubuntu 22.04 LTS？

我个人习惯用LTS版本做开发环境。Ubuntu 22.04是目前比较稳定的选择，软件源里的包版本够新，而且社区支持好。你如果用的是其他发行版，比如Debian或Fedora，原理一样，只是包管理器命令不同。

这里有个小经验：千万别用Windows的WSL1来搞Buildroot，WSL2勉强可以，但文件系统性能有坑。我建议直接用原生Linux，或者虚拟机里装Ubuntu 22.04。

2.2 安装Buildroot依赖

Buildroot对宿主机的依赖其实不多，但一个都不能少。咱们直接上命令：

sudo apt update
sudo apt install -y \
    git \
    make \
    gcc \
    g++ \
    libncurses-dev \
    flex \
    bison \
    gperf \
    python3 \
    python3-pip \
    python3-venv \
    unzip \
    wget \
    cpio \
    rsync \
    bc \
    file \
    libssl-dev \
    libelf-dev \
    u-boot-tools \
    device-tree-compiler

为什么要装这么多？我简单解释几个关键的：

• libncurses-dev：Buildroot的menuconfig图形配置界面依赖它。没它你只能用文本模式配置，那体验...嗯，你懂的。
• flex、bison：这两个是词法分析和语法分析工具。Buildroot内部有些配置解析脚本需要它们。
• cpio、rsync：制作根文件系统镜像时，cpio用来打包，rsync用来同步文件。
• libssl-dev、libelf-dev：编译内核和U-Boot时，这两个库是必须的。我曾经因为漏了libssl-dev，编译内核时报了一堆莫名其妙的证书错误。

2.3 下载Buildroot源码

Buildroot的源码托管在GitHub上。我个人建议用git clone，而不是下载zip包。为什么？因为git可以方便地切换版本、查看历史、打补丁。你想想看，后面如果遇到bug，git bisect能帮你快速定位问题。

cd ~
git clone https://github.com/buildroot/buildroot.git
cd buildroot

默认clone下来的是master分支，也就是开发版。对于学习来说，我建议切到一个稳定的LTS版本。比如2024.02.x系列：

git checkout 2024.02.1

这里有个坑：不要用最新的master分支做生产环境。master分支可能包含未完全测试的代码，我就在项目中遇到过master分支编译出来的内核启动不了的情况。用LTS版本，稳。

2.4 首次编译前的准备

源码下载好了，别急着直接make。咱们先做几件事：

2.4.1 检查依赖是否完整

Buildroot自带一个依赖检查脚本，可以帮你验证环境：

make check-dependencies

如果输出没有报错，说明依赖基本没问题。如果有红色报错，回去补装对应的包。

2.4.2 选择一个默认配置

Buildroot支持很多开发板。咱们先看看有哪些现成的配置：

make list-defconfigs

你会看到一长串列表，比如raspberrypi4_64_defconfig、qemu_x86_64_defconfig等等。对于初学者，我强烈建议先用QEMU的配置，这样不需要真实硬件就能跑起来：

make qemu_x86_64_defconfig

这个命令会在buildroot/目录下生成一个.config文件，里面包含了所有默认配置选项。

2.4.3 配置输出目录（可选但推荐）

Buildroot默认把所有编译产物放在源码目录下的output/文件夹里。我个人习惯把输出目录放到别处，比如/tmp/buildroot_output，这样方便清理：

make O=/tmp/buildroot_output qemu_x86_64_defconfig

注意：一旦指定了O参数，后续所有make命令都要带上这个参数，否则Buildroot会找不到配置。

2.4.4 检查.config文件

用文本编辑器打开.config（或者/tmp/buildroot_output/.config），看看关键选项：

• BR2_x86_64：目标架构，这里应该是y
• BR2_TOOLCHAIN_BUILDROOT：工具链来源，默认是Buildroot自己编译
• BR2_TARGET_GENERIC_HOSTNAME：目标系统的主机名，可以改成你喜欢的

2.5 知识体系总览

下面这张图帮你理清本章的核心逻辑：

2.6 常见问题与避坑

问题1：执行make check-dependencies时报错说缺少某个包，但明明已经装了？

嗯，这种情况我遇到过。通常是32位库的问题。比如你装的是64位系统，但Buildroot需要32位的libncurses。解决方法：

sudo apt install libncurses-dev:i386

问题2：git clone速度太慢怎么办？

国内用户可以用镜像站。我个人习惯用清华的镜像：

git clone https://mirrors.tuna.tsinghua.edu.cn/git/buildroot.git

问题3：执行make qemu_x86_64_defconfig后，想看看具体配置了哪些选项？

用这个命令：

make menuconfig

它会打开一个图形界面，你可以浏览和修改所有配置项。如果终端不支持图形界面，可以用make nconfig，它基于ncurses，兼容性更好。

2.7 验证环境是否就绪

最后一步，咱们快速验证一下：

make check-dependencies
echo $?

如果输出是0，说明依赖全部通过。然后看看.config文件是否存在：

ls -la .config

如果文件存在且大小不为0，恭喜你，环境搭建完成！

好了，环境已经就绪。下一章咱们就开始真正的编译之旅——用Buildroot构建第一个嵌入式系统镜像。

---