2. 编译Busybox：从源码下载到交叉编译，一步步构建你的第一个Busybox二进制文件

好，咱们正式开始动手。上一章聊了Busybox是什么，这一章直接干——把源码变成能跑的二进制文件。

说实话，我第一次编译Busybox的时候，踩了不少坑。交叉编译工具链没配好、配置选项选错、静态链接没打开……折腾了一整天。今天我把这些经验都揉进这一章，你跟着走，基本不会翻车。

2.1 下载源码：选对版本很重要

Busybox的源码托管在 git.busybox.net，也同步到了GitHub。我个人习惯用git拉取，方便切版本。

git clone git://git.busybox.net/busybox
cd busybox
git tag | grep -E '^1_' | tail -10

为什么强调版本？我在项目里吃过亏——某个1.32.x的版本在ARM Cortex-A7上有调度bug，后来才发现是已知问题。所以我的建议是：

  • 稳定优先：选最新的稳定tag，比如 1_36_1 或 1_35_0
  • 避免太新：刚发布的小版本可能有未暴露的兼容问题
  • 记录版本号：方便后续复现和排查
我的习惯：拉完代码后，立刻创建一个本地分支，比如 my-build-1_36_1，这样改配置、打补丁都不会污染主分支。

2.2 配置交叉编译环境

交叉编译，说白了就是“在PC上编译，在ARM板子上跑”。你需要一套交叉编译工具链。

常见的工具链有：

工具链 适用场景 获取方式
arm-linux-gnueabihf- ARM 32位，硬浮点 apt install gcc-arm-linux-gnueabihf
aarch64-linux-gnu- ARM 64位 apt install gcc-aarch64-linux-gnu
buildroot工具链 定制化高，版本可控 自行编译
Linaro工具链 性能优化好，社区活跃 官网下载

我一般用Linaro的预编译工具链，省事。下载后解压，把 bin 目录加到 PATH 里：

export PATH=$PATH:/opt/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin
export CROSS_COMPILE=arm-linux-gnueabihf-
export ARCH=arm
注意：CROSS_COMPILE 变量后面要带短横线 -，否则make找不到编译器。我曾经漏掉这个，编译报错“找不到gcc”，排查了半小时才发现。

2.3 配置Busybox：make menuconfig

进入Busybox源码目录，执行：

make menuconfig

你会看到一个蓝底白字的配置界面。这里有几个关键选项必须改：

  • 静态编译：Settings → Build static binary (no shared libs)，选上。这样生成的busybox不依赖动态库，丢到任何同架构的板子上都能跑。
  • 安装路径：Settings → Destination path for 'make install'，我习惯设成 ./_install。
  • 调试符号：Settings → Debugging symbols，建议选上，方便后续用gdb分析问题。

其他选项保持默认就行。你想想看，Busybox默认配置已经包含了大部分常用命令，够用了。

核心原则：第一次编译，尽量少改配置。跑通了再按需裁剪或添加功能。我见过有人一上来就改了几十个选项，结果编译报错，根本不知道是哪个选项引起的。

2.4 编译：make

配置保存后，直接编译：

make -j$(nproc)

-j$(nproc) 表示用所有CPU核心并行编译，能快不少。我第一次编译时没加 -j，单核跑了快10分钟，加了之后2分钟搞定。

编译过程中如果报错，别慌。常见错误及解决方法：

错误信息 原因 解决方法
arm-linux-gnueabihf-gcc: not found 工具链没在PATH里 检查 export PATH 是否正确
undefined reference to 'xxx' 某些功能依赖的库没选 检查menuconfig中对应选项是否开启
multiple definition of 'yyy' 配置冲突或源码bug 尝试 make clean 后重新配置

编译成功后，你会看到 busybox 这个可执行文件。用 file 命令确认一下：

file busybox
# 输出示例：busybox: ELF 32-bit LSB executable, ARM, version 1 (SYSV), statically linked

看到 statically linked 就对了。

2.5 安装：make install

编译通过后，执行安装：

make install

这会把你之前配置的 _install 目录下生成 bin、sbin、usr 等子目录，里面全是符号链接，都指向 busybox 这个二进制文件。

举个例子：

_install/bin/ls -> ../bin/busybox
_install/bin/cat -> ../bin/busybox
_install/sbin/init -> ../bin/busybox

这就是Busybox的精髓——一个二进制文件，通过符号链接模拟出上百个命令。

2.6 验证：在QEMU上跑一下

光编译成功还不够，得验证它能不能跑。如果你手头没有开发板，可以用QEMU模拟：

qemu-system-arm -M versatilepb -kernel busybox -nographic

当然，这需要你提前准备好内核和设备树。更简单的办法是：

./busybox sh
# 进入Busybox的shell后，试试 ls、cat、echo 等命令

如果是在x86主机上直接运行ARM的busybox，会报 Exec format error，这是正常的——架构不同嘛。

我的经验：在QEMU上验证时，记得把 _install 目录打包成 initramfs，这样内核启动后直接挂载Busybox作为根文件系统。具体做法是：cd _install && find . | cpio -o -H newc | gzip > ../initramfs.cpio.gz。

2.7 本章核心流程图

下面这张图总结了从源码到可运行二进制文件的完整流程：

Busybox编译流程 Busybox 编译流程 下载源码 配置交叉编译环境 make menuconfig make -j$(nproc) make install 验证（QEMU/板子） 关键配置 • 静态编译（Build static binary） • 安装路径（_install） • 调试符号（Debugging symbols） 常见问题 • 工具链不在PATH • 缺少依赖库 • 配置冲突

2.8 避坑指南

最后，分享几个我踩过的坑：

  • 静态链接 vs 动态链接：如果你忘了选静态编译，生成的busybox会依赖 libc.so 等动态库。放到板子上运行时，如果板子上的libc版本不一致，直接报 FATAL: kernel too old 或段错误。所以，嵌入式环境一律静态编译。
  • 工具链版本匹配：我曾经用gcc 9.x的工具链编译Busybox 1.30.x，结果某些命令行为异常。后来换成gcc 7.5就正常了。建议工具链版本不要比源码版本新太多。
  • make clean 的时机：如果你改了配置，一定要 make clean 再重新编译。否则旧的目标文件可能残留，导致奇怪的问题。
← 上一章 📖 返回目录 下一章 →