3、Buildroot源码获取与目录结构

好，咱们正式开始动手了。这一章我带你看看Buildroot的源码怎么拿，以及拿到手之后，那一堆文件夹到底都是干嘛的。说实话，我第一次打开Buildroot目录时也有点懵——怎么这么多东西？别急，我帮你捋一遍。

3.1 下载Buildroot源码

获取Buildroot源码的方式很简单，就两种：要么从官网下载压缩包，要么用git克隆。我个人更推荐git方式，为什么呢？因为方便切换版本，也方便看更新历史。

方式一：官网下载

去 buildroot.org 的下载页面，找到你想要的版本。比如长期支持版（LTS）或者最新稳定版。下载后解压就行：

wget https://buildroot.org/downloads/buildroot-2024.02.tar.gz
tar -xzf buildroot-2024.02.tar.gz
cd buildroot-2024.02/

方式二：git克隆（我推荐）

用git可以随时拉取最新代码，也能切到任意历史版本：

git clone https://git.buildroot.net/buildroot
cd buildroot
git tag -l  # 看看有哪些版本标签
git checkout 2024.02  # 切到指定版本

3.2 顶层目录结构概览

解压或克隆完成后，咱们看看顶层都有什么。我用 ls -l 列一下核心目录：

board/          # 板级支持文件
configs/        # 默认配置文件
package/        # 软件包构建规则
toolchain/      # 工具链相关
linux/          # Linux内核构建
boot/           # 引导加载程序
system/         # 根文件系统骨架
fs/             # 文件系统生成
support/        # 辅助脚本和工具
utils/          # 实用工具
docs/           # 文档
Makefile        # 主Makefile
Config.in       # 顶层配置菜单

嗯，看着不少对吧？但别慌，咱们挑几个最重要的说。

3.3 核心目录详解

board/ —— 板级支持文件

这个目录存放的是针对特定硬件平台的配置文件、内核补丁、设备树、根文件系统覆盖层等。比如树莓派、BeagleBone、QEMU模拟器等等。

举个例子，你打开 board/raspberrypi/ 看看：

board/raspberrypi/
├── post-build.sh
├── post-image.sh
├── rootfs-overlay/
│   └── etc/
│       └── ...
└── readme.txt

post-build.sh 和 post-image.sh 是构建完成后执行的脚本。我在项目中经常用 post-build.sh 来修改一些配置文件，比如设置默认的hostname、添加用户等。

configs/ —— 默认配置

这里存放的是各种开发板的默认配置。每个配置文件对应一个完整的Buildroot配置。比如：

configs/
├── raspberrypi4_64_defconfig
├── beaglebone_defconfig
├── qemu_x86_64_defconfig
└── ...

使用方式很简单：

make raspberrypi4_64_defconfig

这条命令会把 configs/raspberrypi4_64_defconfig 的内容加载到 .config 中。说白了，这就是一个「一键配置」的入口。

我曾经犯过一个错误：直接修改 configs/ 下的文件，然后 make 发现没生效。后来才意识到，make xxx_defconfig 只是把配置复制到 .config，后续修改要保存回 configs/ 得用 make savedefconfig。嗯，这个坑我替你们踩过了。

package/ —— 软件包构建规则

这是Buildroot最核心的目录之一。每个软件包都有一个子目录，里面包含 Config.in 和 .mk 文件。比如：

package/
├── busybox/
│   ├── Config.in
│   └── busybox.mk
├── dropbear/
│   ├── Config.in
│   └── dropbear.mk
└── ...

Config.in 是Kconfig格式的菜单配置，决定这个包是否被选中。.mk 文件是Makefile片段，定义了如何下载、配置、编译、安装这个包。

如果你要添加一个自己的软件包，就在 package/ 下新建一个目录，写这两个文件。我在课程后面会专门讲怎么添加自定义包。

toolchain/ —— 工具链

这个目录包含工具链相关的配置和构建逻辑。Buildroot支持三种工具链方式：

• 内部工具链：Buildroot自己编译gcc、binutils、glibc/uclibc/musl
• 外部工具链：使用预编译的工具链，比如Linaro、ARM官方提供的
• 系统工具链：使用宿主机自带的工具链（不推荐交叉编译时使用）

我个人习惯用内部工具链，因为可控性高。但如果你赶时间，用外部工具链能省不少编译时间。我记得有一次给一个ARM Cortex-A7的板子做系统，用内部工具链编译glibc花了将近一个小时，换成Linaro的预编译工具链，十分钟就搞定了。

3.4 版本选择策略

Buildroot的版本号规则是这样的：YYYY.MM，比如 2024.02、2024.08。每年2月和8月各发布一个版本。其中：

• 偶数年.02（如2024.02）是LTS版本，维护周期长，适合产品化
• 偶数年.08（如2024.08）是普通稳定版，功能更新多
• 奇数年版本一般不推荐用于生产

版本	类型	维护周期	推荐场景
2024.02	LTS	~2年	产品量产、长期维护
2024.08	稳定版	~1年	开发验证、新功能尝鲜
2025.02	普通版	~1年	一般不推荐

我的建议是：

• 做产品用最新的LTS版本（比如2024.02）
• 学习或原型验证可以用最新稳定版（比如2024.08）
• 不要追新，稳定第一

3.5 知识体系结构图

下面这张图帮你理清Buildroot源码目录的核心逻辑：

3.6 本章小结

这一章我们做了三件事：下载了Buildroot源码、理清了顶层目录结构、搞懂了版本选择策略。你想想看，现在你打开Buildroot目录，应该能一眼认出哪些是核心目录了。

下一章我们会真正开始配置和构建，到时候这些目录的作用会更清晰。嗯，先消化一下今天的内容吧。

---

公众号:蓝海资料掘金营，微信deep3321