第三章 获取BusyBox源码：从官网下载、Git仓库克隆、查看源码目录结构

好，咱们正式开始动手了。这一章我带你搞定一件事——拿到BusyBox的源码。别小看这一步，选错版本、下错分支，后面编译时能让你抓狂。我当年刚入行时就吃过这个亏，嗯，咱们一次走对。

3.1 从官网下载稳定版源码

我个人习惯，做产品优先用稳定版。BusyBox的官网是 https://busybox.net，进去后点「Download」就能看到所有发布版本。

为什么要用稳定版？说白了，稳定版经过了充分测试，bug少。我在项目中遇到过，用开发版编译出来的文件系统，跑着跑着突然崩溃，查了两天才发现是某个新特性有内存泄漏。从那以后，我学乖了——产品用稳定版，玩票可以用最新版。

下载命令很简单，用wget就行：

# 以1.36.1版本为例
wget https://busybox.net/downloads/busybox-1.36.1.tar.bz2

# 解压
tar -xjf busybox-1.36.1.tar.bz2
cd busybox-1.36.1/

解压后你会看到一个 busybox-1.36.1 目录。进去看看，里面大概有这些顶层内容：

busybox-1.36.1/
├── applets/        # 每个命令的入口文件
├── archival/       # 压缩/归档工具（tar、gzip等）
├── coreutils/      # 核心工具（cp、mv、rm等）
├── debianutils/    # Debian系统相关工具
├── editors/        # 编辑器（vi、sed等）
├── findutils/      # 查找工具（find、grep等）
├── init/           # init进程相关
├── libbb/          # 公共库函数
├── loginutils/     # 登录管理工具
├── mailutils/      # 邮件工具
├── miscutils/      # 杂项工具
├── modutils/       # 模块工具
├── networking/     # 网络工具（ifconfig、ping等）
├── printutils/     # 打印工具
├── procps/         # 进程管理工具
├── runit/          # 服务监督工具
├── selinux/        # SELinux支持
├── shell/          # Shell（ash、hush等）
├── sysklogd/       # 系统日志工具
├── util-linux/     # Linux工具（mount、fdisk等）
├── Makefile        # 主Makefile
├── Config.in       # 配置菜单入口
└── docs/           # 文档目录

你看，每个目录对应一类工具。这种分类方式很清晰，想改哪个命令就去哪个目录找。我刚开始看时觉得目录太多，后来发现其实就几个核心目录经常打交道。

3.2 从Git仓库克隆最新源码

如果你想跟踪最新开发进度，或者给BusyBox贡献代码，那就得用Git了。BusyBox的官方仓库在 git.busybox.net。

克隆命令：

git clone git://git.busybox.net/busybox
cd busybox

这会下载完整的历史记录，大概几十MB。如果你只想看最新代码，可以加 --depth 1：

git clone --depth 1 git://git.busybox.net/busybox

为什么要加 --depth 1？你想想看，嵌入式开发板上存储空间本来就紧张，下载完整历史记录纯属浪费。我一般只在需要查某个bug的提交记录时，才会拉全量。

克隆完后，目录结构和官网下载的几乎一样。区别在于Git仓库里多了 .git 目录，以及可能有一些未合并的补丁。

3.3 深入理解源码目录结构

光知道目录名字不够，咱们得明白每个目录是干嘛的。我挑几个重点目录说说：

3.3.1 applets/ —— 命令的入口

这个目录很重要。每个BusyBox命令都在这里有一个 .c 文件，比如 applets/ls.c 就是 ls 命令的入口。这些文件很小，主要工作是调用对应功能模块里的函数。

举个例子，打开 applets/ls.c 看看：

//applets/ls.c 简化版
int ls_main(int argc, char **argv) {
    // 解析参数
    // 调用 coreutils/ls.c 里的实际功能
    return 0;
}

说白了，applets目录就像个「前台接待」，真正的干活的人在后面的功能目录里。

3.3.2 libbb/ —— 公共工具箱

这个目录我特别喜欢。它包含了所有命令公用的函数，比如字符串操作、文件读写、内存分配等。你想想看，如果每个命令都自己实现一套 strcpy，那得多浪费空间？

libbb里常用的文件：

文件名	功能
bb_strtod.c	字符串转数字
copy_file.c	文件复制
getopt32.c	命令行参数解析
safe_strncpy.c	安全的字符串拷贝
verror_msg.c	错误信息输出

我在项目中遇到过，自己写的工具函数和libbb里的重名了，结果链接时报错。后来我学乖了，先看看libbb里有没有现成的，有就直接用。

3.3.3 Config.in 和 Makefile —— 构建系统的核心

Config.in 是配置菜单的描述文件，它定义了每个功能开关。比如你想开启或关闭某个命令，就是在 make menuconfig 里操作，而菜单的内容就来自 Config.in。

Makefile 是编译的指挥中心。BusyBox的Makefile写得相当精巧，它会自动扫描各个目录下的源文件，决定哪些需要编译。

3.3.4 docs/ —— 别忽略的宝藏

这个目录里有很多文档，比如 docs/busybox.net 的离线版、docs/embedded.txt 嵌入式系统指南等。我建议你花半小时翻翻 docs/embedded.txt，里面有很多关于如何裁剪BusyBox的实战经验。

3.4 本章知识体系图

下面这张图帮你理清源码获取和目录结构的脉络：

3.5 避坑指南

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

• 版本不匹配：我曾经用1.35.x的配置去编译1.36.x的源码，结果一堆编译错误。记住，配置文件和源码版本必须一致。
• Git浅克隆的坑：如果你用 --depth 1 克隆，后面想切分支会失败。需要时可以用 git fetch --unshallow 补全历史。
• 权限问题：下载的源码默认是只读的？用 chmod -R u+w busybox-1.36.1/ 加写权限。
• 中文乱码：官网下载的tar包在Windows下解压可能乱码。建议在Linux或WSL下操作。

好了，源码已经到手，目录结构也清楚了。下一章咱们就开始配置和编译，真正把BusyBox跑起来。

可可精品资料库