3、Buildroot目录结构：顶层目录、package目录、configs目录、board目录、output目录详解

说实话，我第一次接触Buildroot时，也被它的目录结构搞得有点懵。那么多文件夹，到底哪个是干嘛的？

后来在项目中摸爬滚打，才慢慢摸清了门道。今天我就带你把这些目录挨个捋一遍。你想想看，搞懂了目录结构，后面定制根文件系统就顺手多了。

3.1 顶层目录：项目的总指挥部

Buildroot解压后，你首先看到的就是顶层目录。这里面放的都是核心配置文件和控制脚本。

我个人习惯把顶层目录比作「总指挥部」。它不直接参与编译，但所有编译行为都由它调度。

顶层目录里最重要的几个文件：

• Makefile：整个Buildroot的入口。你执行make命令时，就是它在干活。
• Config.in：顶层配置菜单。运行make menuconfig时，它决定了你能看到哪些选项。
• Config.in.legacy：存放废弃选项。升级Buildroot版本时，这里会告诉你哪些配置被移除了。

3.2 package目录：软件包的仓库

这个目录是Buildroot的核心。说白了，所有你想编译进根文件系统的软件，都在这里。

每个软件包都有自己的子目录，比如package/busybox/、package/openssh/。每个子目录里通常包含：

• Config.in：这个包的配置选项。你在menuconfig里看到的开关，就是它定义的。
• <包名>.mk：编译规则。告诉Buildroot怎么下载、配置、编译、安装这个包。
• <包名>.hash：校验文件。确保下载的源码包没被篡改。

举个例子，我们看看package/busybox/：

package/busybox/
├── Config.in
├── busybox.mk
├── busybox.hash
├── S01busybox-klogd
└── S01busybox-syslogd

嗯，这里要注意。后面那两个S01开头的文件，是Busybox的启动脚本。Buildroot会自动把它们安装到/etc/init.d/目录下。

3.3 configs目录：一键配置的捷径

这个目录里放的是各种开发板的默认配置文件。文件名通常叫<板子名>_defconfig。

比如：

• raspberrypi3_defconfig：树莓派3的配置
• beaglebone_defconfig：BeagleBone的配置
• qemu_x86_64_defconfig：QEMU模拟器的配置

使用方式很简单：

make raspberrypi3_defconfig
make

两行命令，Buildroot就会自动下载工具链、内核、软件包，编译出一个完整的根文件系统。

我记得刚带团队时，有个新人问我：「为什么我每次都要重新配置？」我告诉他，把你的配置保存成myboard_defconfig放到configs/下，下次直接make myboard_defconfig就行了。他当时那个恍然大悟的表情，我到现在还记得。

make savedefconfig
cp defconfig configs/myboard_defconfig

3.4 board目录：板级支持文件

这个目录存放的是跟具体硬件平台相关的文件。比如：

• 设备树文件（.dts、.dtsi）
• U-Boot的补丁或配置文件
• 根文件系统的覆盖文件（overlay）
• 生成镜像的脚本

目录结构通常按厂商和板子组织：

board/
├── raspberrypi/
│   ├── rpi3/
│   │   ├── config.txt
│   │   ├── cmdline.txt
│   │   └── post-image.sh
│   └── rpi4/
│       └── ...
└── beaglebone/
    └── ...

这里有个关键概念叫「rootfs overlay」。你可以在board/下放一个rootfs-overlay/目录，里面的文件会直接覆盖到生成的根文件系统中。

我曾经在调试一个工控设备时，需要往根文件系统里放一个校准文件。直接在board/myboard/rootfs-overlay/etc/calibration.conf里放好，Buildroot编译时自动就合并进去了。省去了手动拷贝的麻烦。

3.5 output目录：编译成果的集散地

这个目录是Buildroot编译时自动生成的。你执行make后，所有中间文件和最终产物都在这里。

output目录的结构：

这里有个实用技巧：

# 查看根文件系统里有什么
ls output/target/

# 查看最终生成的镜像
ls -lh output/images/

# 清理某个包，重新编译
make busybox-dirclean
make busybox

我个人最常用的是output/target/。调试时，我会直接进去检查文件有没有放对位置，库有没有缺失。你想想看，如果每次都要烧录到板子上再验证，那效率得多低。

3.6 目录之间的协作关系

这些目录不是孤立的。它们之间有一条清晰的协作链：

1. configs/ 提供配置 → 决定编译哪些 package/ 里的软件包
2. board/ 提供板级文件 → 影响 output/target/ 的内容
3. package/ 里的编译规则 → 生成 output/build/ 和 output/target/
4. output/images/ 是最终产物 → 可以直接烧录到板子上

举个例子，你执行make raspberrypi3_defconfig时：

• Buildroot从configs/读取配置
• 根据配置，从package/下载并编译需要的软件包
• 从board/raspberrypi/rpi3/拷贝设备树和启动文件
• 最终在output/images/生成sdcard.img

嗯，这套流程我调试过无数次。每次看到output/images/里生成镜像文件，心里就踏实了。

make clean
make

好了，Buildroot的目录结构就讲到这里。搞懂了这些目录的职责和关系，后面定制根文件系统时，你就知道该动哪里、不该动哪里了。