Mini Config：从零设计一份精简的内核配置

做什么

这篇我们要做一件很多人不会告诉你的事——亲手设计一份精简的内核配置，而不是无脑用 defconfig。最终我们会得到一份只包含 QEMU virt 机器启动所需最小功能集的内核配置，它只有 442 个 =y 配置项，而 defconfig 有 952 个。

啊，你说咱们这么快就动手嘛？对啊，不然呢？哈哈！咱们自己，亲手来配置一份内核，香不香？

要了解什么

defconfig 的问题

defconfig 是内核源码里预定义的默认配置，对于 ARM64 来说它位于 arch/arm64/configs/defconfig。跑一遍 make defconfig 就能得到一份"能跑"的内核配置，听起来很美好，问题是这份配置包含了大量真实 SoC 的驱动——GPU、音频、各种开发板的外设驱动等等。我们用 QEMU virt 机器做内核学习，根本不需要这些硬件支持，它们除了拖慢编译速度和分散注意力之外没有任何用处。

更直白地说，952 个 =y 项里面有超过一半是我们永远用不到的，编译出来多出的那几百个驱动在 QEMU 里也全都是 dead code。与其在一个臃肿的内核里学习，不如我们自己来裁剪。

三步配置流程

我们的策略是"从零开始，按需开启"，具体分三步走。

第一步，用 allnoconfig 生成一个几乎全关的基础配置。这个目标会让所有非必须的配置项都设为 n，只保留架构本身的硬性依赖。对于 ARM64 来说，生成的 .config 大约只有几十个选项是开着的，其他全部关闭。

cd third_party/linux
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- \
     O=../../out/build_latest_arm64 allnoconfig

第二步，用 merge_config.sh 把我们准备好的 config fragment 合并进去。这个脚本位于内核源码的 scripts/kconfig/ 目录下，它的工作方式是把 fragment 文件里的配置项逐条合并到基础配置中——遇到 =y 就开启，遇到 =m 就设为模块。-m 参数后面跟的是目标 .config 文件路径：

scripts/kconfig/merge_config.sh -m \
    ../../out/build_latest_arm64/.config \
    ../../configs/arm64-qemu-virt-learn.config

第三步，用 olddefconfig 让内核构建系统自动补齐所有依赖。我们手写的 fragment 只列了"我们知道自己需要的"选项，但内核配置之间有大量隐式依赖——比如开启了 CONFIG_PRINTK=y，它可能还依赖其他几个配置项。olddefconfig 会遍历整个配置树，把缺失的依赖全部自动补上，同时对新出现的配置项使用默认值：

make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- \
     O=../../out/build_latest_arm64 olddefconfig

三步走完之后，最终的 .config 从几十项膨胀到了 442 项——多出来的那些全是 olddefconfig 自动补齐的依赖。这个数字依然只有 defconfig 的一半不到，而且每一个开启的配置项都能追溯到我们 fragment 里的某个明确需求。

Config Fragment 的设计思路

我们准备好的 fragment 文件是 configs/arm64-qemu-virt-learn.config，它按功能分类组织，每一组都有注释说明"为什么需要这些配置"。当然，您可能会问这些都是啥。如果您不是很清楚——一个最好的办法就是递归下降法的查询相关的概念。我们这里快速的说一下这些内容都是啥：

先说平台基础。ARM64 架构本身是必须的，SMP（对称多处理器）也要开，因为我们后续的 QEMU 启动会配两个 CPU 核：

CONFIG_ARM64=y
CONFIG_64BIT=y
CONFIG_SMP=y
CONFIG_NR_CPUS=2

接下来是串口控制台。QEMU virt 机器用 ARM PL011 UART 做串口输出，console=ttyAMA0 内核启动参数指向的就是它。不开这些配置的话，内核启动后你什么都看不到——没有启动日志，没有 shell 提示符，整个世界一片寂静：

CONFIG_TTY=y
CONFIG_SERIAL_AMBA_PL011=y
CONFIG_SERIAL_AMBA_PL011_CONSOLE=y

然后是 initramfs 支持。我们的根文件系统会打包成 cpio.gz 格式作为 initrd 加载，内核必须支持 gzip 解压才能解包它：

CONFIG_BLK_DEV_INITRD=y
CONFIG_RD_GZIP=y

文件系统方面，devtmpfs 让内核自动在 /dev 下创建设备节点，procfs 和 sysfs 分别提供 /proc 和 /sys 的内核信息接口，tmpfs 用于内存文件系统——这四个是 BusyBox shell 能正常工作的基本前提。内核模块相关的配置让我们后续可以加载和卸载 .ko 模块，而调试支持那一组（DEBUG_INFO、GDB_SCRIPTS、KALLSYMS）是为 GDB 远程调试准备的。

整个 fragment 大概 40 行，每个配置项都有一行注释说明它的用途和依赖关系。这种"最小化 + 注释"的方式让配置文件本身就成了一份学习笔记。

踩坑记录

这三步流程说起来简单，但实际操作的时候我们踩了不少坑，这里把最值得记录的几个列出来。

"The source tree is not clean"

这是最容易遇到的问题。内核 Makefile 里面有一个检查逻辑（在 Makefile 的 outputmakefile 目标中），当你使用 O= 分离编译目录时，它会检测源码树根目录下是否存在 .config 文件、include/config/ 目录、或者 arch/arm64/include/generated/ 目录。只要检测到其中任何一个，就会判定"源码树不干净"然后拒绝继续。

我们碰到的情况是这样的：之前直接在源码树里跑过 defconfig 测试，虽然后来用 make mrproper 清理了大部分产物，但 merge_config.sh 在执行过程中会在源码树根目录创建一个 .config 文件（这是它的一个副作用），导致后续的 olddefconfig 报错。解决办法很直接——手动删除残留的 .config：

rm -f third_party/linux/.config

预防这个问题的核心原则是：用 O= 编译时，永远不要在源码树里直接跑 make。如果确实需要在源码树里操作（比如 merge_config.sh），操作完立刻检查并清理 .config。

merge_config.sh 的参数

-m 参数后面跟的是目标 .config 文件的完整路径，不是目录路径。它直接就地修改这个文件，把 fragment 里的配置项合并进去。所以正确的调用方式是 merge_config.sh -m <output_dir>/.config <fragment>，而不是 merge_config.sh -m <output_dir> <fragment>。

忘记设 ARCH 编译成了 x86

这个坑真的很经典。内核构建系统根据 ARCH 变量决定目标架构，不设就默认宿主架构（WSL2 里是 x86_64）。CROSS_COMPILE 不设就用本机 gcc。结果就是 make -j14 跑完了，输出 arch/x86/boot/bzImage is ready——编译了半天全是白费。

解决办法有两个：要么每一行 make 命令都带 ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu-，要么在 shell 里 export 这两个变量。后者更省心，但要注意 export 只对当前 shell 会话有效，关掉终端重新开就得再设一次。

工作目录与 make -C

从项目根目录 PenguinLab/ 直接跑 make O=... Image 会报 No targets specified and no makefile found，因为项目根目录没有内核的 Makefile。要么先 cd third_party/linux 再跑 make，要么用 make -C third_party/linux 显式指定源码目录。

动手试试

确认 third_party/linux/Makefile 存在，如果不存在先运行 ./scripts/linux-submodule.sh init 拉取内核源码
按顺序执行三步配置流程：allnoconfig → merge_config.sh → olddefconfig，注意每步都带 ARCH 和 CROSS_COMPILE
用 grep -c "=y" out/build_latest_arm64/.config 统计最终配置项数量，应该看到 400-500 之间
用 diff <(grep "=y" out/build_latest_arm64/.config | sort) <(grep "=y" <(make ARCH=arm64 O=../../out/build_latest_arm64 defconfig && cat ../../out/build_latest_arm64/.config) | sort) 对比一下和 defconfig 的差距，看看我们砍掉了哪些东西

做什么​

要了解什么​

defconfig 的问题​

三步配置流程​

Config Fragment 的设计思路​

踩坑记录​

动手试试​

延伸阅读​

做什么