4、目录结构：深度解析Buildroot顶层目录，每个文件夹是干什么的？

说实话，我第一次打开Buildroot的顶层目录时，也有点懵。一堆文件夹，名字看着眼熟，但具体干嘛的，心里没底。后来做项目多了，才慢慢摸清门道。今天我就带你挨个走一遍，把这些文件夹的底细都抖出来。

4.1 顶层目录概览

你下载Buildroot源码后，解压出来，会看到这么几个核心目录。我习惯把它们分成三类：核心构建类、配置类、输出类。咱们一个一个说。

4.2 核心构建目录详解

4.2.1 arch/ — 架构的根

这个目录存放着不同CPU架构的配置。比如ARM、x86、MIPS、RISC-V等等。里面主要是些Makefile片段和配置文件。说白了，就是告诉Buildroot：「我这个架构的CPU，编译参数该怎么设，浮点用硬浮点还是软浮点？」

我记得有一次做ARM Cortex-A7的项目，死活编译不过。查了半天，发现是arch/arm/下的ARMv7配置里，有个浮点选项没开。嗯，这种坑，你不看这个目录，根本想不到。

4.2.2 board/ — 你的板子，你的地盘

这是我最常打交道的目录之一。board/下面按厂商或板子名字分文件夹。比如board/raspberrypi/、board/beaglebone/。每个文件夹里放着：

• 设备树文件（.dts/.dtsi）
• 分区表配置
• 根文件系统的覆盖文件（overlay）
• 一些板子特有的脚本

说白了，你的硬件长什么样，这里说了算。我建议你拿到一块新板子，第一件事就是看看board/下有没有现成的支持。没有？那就得自己动手了。

4.2.3 boot/ — 引导加载程序

这里放的是Bootloader的构建逻辑。最常见的就是U-Boot和Barebox。每个Bootloader一个子目录，里面有它的下载地址、补丁、配置选项。

我个人习惯，如果板子用U-Boot，我会先在这里看看默认配置。很多时候，官方给的配置就能直接跑起来。但要注意，有些板子的U-Boot配置藏在board/目录下，别找错了地方。

4.2.4 linux/ — 内核构建的核心

这个目录负责Linux内核的下载、配置、编译。里面有个linux.mk文件，是内核构建的主逻辑。你可以在make menuconfig里选内核版本、配置片段（defconfig）、补丁等。

我曾经踩过一个坑：内核版本选得太新，结果某个驱动在Buildroot里还没适配。后来我学乖了，先看linux/目录下支持的版本列表，再决定用哪个。

4.2.5 package/ — 软件包的大本营

这是Buildroot里最大的目录，没有之一。每个软件包一个子文件夹，比如package/busybox/、package/openssh/。每个文件夹里通常包含：

• Config.in — 菜单配置选项
• *.mk — 构建规则（下载、编译、安装）
• *.hash — 校验文件
• 可选的补丁文件

你想想看，你要加一个自己的软件包，就得在这里新建一个文件夹。我刚开始写自己的.mk文件时，经常抄package/busybox/的模板。抄多了，自然就懂了。

4.3 配置与输出目录

4.3.1 configs/ — 一键配置的秘诀

这里存放着各种开发板的默认配置文件。比如raspberrypi3_64_defconfig。你执行make raspberrypi3_64_defconfig，Buildroot就会自动加载这个文件里的所有选项。

我建议你，每次调好一个项目的配置后，用make savedefconfig把配置保存到这里。下次重装系统，或者同事要用，直接make xxx_defconfig就完事了。省心。

4.3.2 dl/ — 下载缓存，别乱删

这个目录是Buildroot自动创建的。所有从网上下载的源码包、补丁，都缓存到这里。我第一次编译时，网络慢得要命，等了好久。第二次编译，发现dl/里有缓存，嗖的一下就过了。

4.3.3 output/ — 构建成果的集散地

这是Buildroot默认的构建输出目录。里面结构是这样的：

• output/build/ — 每个软件包的解压和编译目录
• output/host/ — 主机工具，比如交叉编译器
• output/staging/ — 头文件和库的「暂存区」
• output/target/ — 目标板的根文件系统
• output/images/ — 最终镜像文件，比如zImage、rootfs.ext4

我最常看的是output/images/。编译完了，直接去那里拿镜像烧录。有一次我找半天找不到内核，后来发现是配置里把输出路径改了。嗯，默认路径最省心。

4.4 辅助与工具目录

4.4.1 fs/ — 文件系统的魔法

这个目录负责生成各种格式的根文件系统。比如ext4、squashfs、ubifs、cpio等。每个格式一个子目录，里面有对应的生成脚本和配置。

我做过一个产品，要求用squashfs只读文件系统。当时就是在这里找到的配置选项。你只要在make menuconfig里选好格式，Buildroot会自动调用fs/下的逻辑来打包。

4.4.2 toolchain/ — 工具链的管家

这里管理着交叉编译工具链。你可以选择使用Buildroot内置的工具链（自己编译），也可以使用外部工具链（比如Linaro提供的）。

我个人建议，新手先用内置工具链。省事。等你有经验了，再用外部工具链，因为有时候外部工具链优化得更好。我曾经为了一个性能问题，把内置工具链换成Linaro的，性能提升了15%。

4.4.3 support/ 和 docs/

support/里是一些辅助脚本，比如kconfig/（菜单配置的底层实现）、misc/（杂项工具）。docs/就是官方文档，说实话，我很少看，因为Buildroot的文档写得比较简略。我更喜欢看代码和网上教程。

4.5 避坑指南与个人经验

还有一点，dl/目录虽然可以缓存，但如果你换了网络环境，或者某个包的下载地址变了，记得清空dl/里对应的文件，让它重新下载。不然你会遇到莫名其妙的校验错误。

最后，我建议你花点时间，把package/目录下的几个经典包（比如busybox、dropbear）的.mk文件读一遍。读懂了它们，你就掌握了Buildroot的软件包构建哲学。说白了，Buildroot就是个大型的Makefile集合，理解了它的套路，你就自由了。

好了，目录结构就讲到这里。下一章，我们会深入package/目录，手把手教你如何添加一个自己的软件包。到时候见。