零基础内核编译zImage 镜像编译生成全程实操作者黒漂技术佬 | 系列Linux内核配置与移植引言前面几篇讲的都是理论和配置我知道你已经手痒了。这篇就带你从头到尾走一遍从零开始编译 ARM Linux 内核的全过程。不需要板子不需要烧录就在 PC 上把 zImage 镜像编译出来看懂每一步在干什么。一、编译环境搭建1.1 安装必要工具内核编译需要以下工具不同发行版命令略有差异# Ubuntu/Debian 推荐命令sudoaptupdatesudoaptinstall-y\build-essential\gcc\make\libncurses5-dev\flex\bison\bc\libssl-dev\libelf-dev\perl\git\rsync\u-boot-tools逐个说明这些包的作用包名用途build-essentialgcc、make 等编译基础工具集合libncurses5-devmenuconfig 图形界面依赖flex / bison词法/语法分析器用于 DTC 编译器编译bc内核编译过程中需要用到数学计算libssl-dev内核模块签名所需libelf-dev处理 ELF 文件格式u-boot-tools提供mkimage工具生成 uImage1.2 安装交叉编译器ARM 嵌入式开发需要在 x86 PC 上编译出 ARM 指令集的代码这需要交叉编译工具链。推荐 Linaro 版本# 下载 Linaro 交叉编译器wgethttps://releases.linaro.org/components/toolchain/binaries/7.5-2019.12/arm-linux-gnueabihf/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz# 解压到 /optsudotar-xfgcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz-C/opt# 添加到 PATHexportPATH/opt/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin:$PATHechoexport PATH/opt/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin:$PATH~/.bashrc# 验证安装arm-linux-gnueabihf-gcc--version输出类似arm-linux-gnueabihf-gcc (Linaro GCC 7.5-2019.12) 7.5.0则表示安装成功。交叉编译器的命名规则前缀部分含义arm-ARM 32位架构linux-目标系统是 Linuxgnueabihf-glibc C库 硬件浮点(hard-float)二、获取内核源码# 从 kernel.org 下载 LTS 版本这里以 5.10 为例wgethttps://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.10.210.tar.xz# 解压tar-xflinux-5.10.210.tar.xzcdlinux-5.10.210解压后执行ls看一眼目录结构确认源码完整。三、配置内核这里使用 arm 架构下versatile_defconfig作为基础配置它是 QEMU 支持的一种 ARM 开发板配置方便验证# 加载默认配置makeARCHarmCROSS_COMPILEarm-linux-gnueabihf- versatile_defconfig# 进入图形化配置界面微调makeARCHarmCROSS_COMPILEarm-linux-gnueabihf- menuconfig在 menuconfig 中你至少可以确认以下设置General setup ---→ 确认Kernel compression mode为 GzipDevice Drivers ---→ 检查串口和块设备驱动是开启的File systems ---→ 确保 ext4 支持是[*]配置完成后保存退出.config文件就生成好了。四、编译内核4.1 第一步编译内核本体makeARCHarmCROSS_COMPILEarm-linux-gnueabihf- -j$(nproc)参数说明参数含义ARCHarm指定目标架构为 ARMCROSS_COMPILE...指定交叉编译器前缀-j$(nproc)并行编译使用所有CPU核心加速编译过程会输出大量信息正常情况下持续数分钟到十几分钟取决于你的CPU性能和内核配置大小。编译成功后会看到Kernel: arch/arm/boot/zImage is ready4.2 第二步编译设备树makeARCHarmCROSS_COMPILEarm-linux-gnueabihf- dtbs这会编译arch/arm/boot/dts/下所有的.dts文件生成对应的.dtb文件。4.3 第三步编译模块如果有选 M 的话makeARCHarmCROSS_COMPILEarm-linux-gnueabihf- modules五、编译产物详解编译完成后我们来盘点一下都生成了哪些文件arch/arm/boot/ ├── Image # 未压缩的原始内核镜像通常10MB ├── zImage # ★ 最常用的压缩内核镜像~3-5MB ├── dts/ │ ├── versatile-ab.dtb # 设备树二进制文件 │ └── versatile-pb.dtb └── compressed/ ├── vmlinux.bin.z # 压缩后的内核二进制 └── head.o # 解压启动代码产物说明用途vmlinux源码根目录下原始的 ELF 格式内核调试用不用于启动Image去掉了符号表和调试信息的裸二进制不含解压代码体积大zImageImage 经过 gzip 压缩 自解压头U-Boot 启动用的就是这个uImagezImage 加上 U-Boot 的 64 字节头老版本 U-Boot 使用需 mkimage*.dtb设备树二进制文件与 zImage 一起传给 U-Boot*.ko内核模块文件放在根文件系统的/lib/modules/zImage 的启动流程U-Boot 加载 zImage/ └── 头部自解压代码先执行 └── 解压出 Image └── 跳转到内核入口开始执行内核六、如何使用 QEMU 验证编译结果不需要物理开发板也能验证内核编译是否正确# 安装 QEMUsudoaptinstall-yqemu-system-arm# 用 QEMU 启动编译好的内核qemu-system-arm-Mversatilepb\-kernelarch/arm/boot/zImage\-dtbarch/arm/boot/dts/versatile-pb.dtb\-nographic\-appendconsolettyAMA0如果一切正常你会看到内核启动日志最终停在Kernel panic - not syncing: VFS: Unable to mount root fs on unknown-block(0,0)这个Kernel panic是正常的——因为我们没有提供根文件系统。内核能启动到这一步说明编译完全正确。七、编译常见错误与解决错误1arm-linux-gnueabihf-gcc: command not found原因交叉编译器未安装或未加入 PATHwhicharm-linux-gnueabihf-gcc# 检查是否在 PATH 中exportPATH/opt/xxx/bin:$PATH# 手动添加错误2fatal error: openssl/bio.h: No such file or directory原因缺少 libssl-devsudoaptinstalllibssl-dev错误3scripts/dtc/yamltree.c:17:10: fatal error: yaml.h: No such file or directory原因缺少 libyaml-dev内核 5.x 设备树校验需要sudoaptinstalllibyaml-dev错误4CONFIG_CC_STACKPROTECTOR_STRONG相关编译失败解决方案在 menuconfig 中关闭该选项General setup --- [ ] Stack Protector buffer overflow detection错误5multiple definition of yylloc解决方案内核版本太新交叉编译器太老。降级内核或升级交叉编译器。八、编译优化技巧8.1 使用 ccache 加速二次编译sudoaptinstallccacheexportCCccache arm-linux-gnueabihf-gccmakeARCHarmCROSS_COMPILEarm-linux-gnueabihf- -j$(nproc)第一次编译速度和原来一样但从第二次开始ccache 会命中缓存速度能提升 5~10 倍。8.2 只编译特定文件改了一个.c文件不想全量重编直接用# 只编译并链接 drivers/gpio/gpiolib.omakeARCHarmCROSS_COMPILEarm-linux-gnueabihf- drivers/gpio/gpiolib.o总结从环境搭建到 zImage 生成Linux 内核编译的全过程就这些步骤装交叉编译器 → 下源码 → 加载配置 → menuconfig 微调 → make 编译 → 拿到 zImage 和 dtb。虽然中间可能遇到依赖和版本兼容问题但只要理清流程99% 的错误都能通过查日志和补装依赖解决。
零基础内核编译zImage 镜像编译生成全程实操作者黒漂技术佬 | 系列Linux内核配置与移植引言前面几篇讲的都是理论和配置我知道你已经手痒了。这篇就带你从头到尾走一遍从零开始编译 ARM Linux 内核的全过程。不需要板子不需要烧录就在 PC 上把 zImage 镜像编译出来看懂每一步在干什么。一、编译环境搭建1.1 安装必要工具内核编译需要以下工具不同发行版命令略有差异# Ubuntu/Debian 推荐命令sudoaptupdatesudoaptinstall-y\build-essential\gcc\make\libncurses5-dev\flex\bison\bc\libssl-dev\libelf-dev\perl\git\rsync\u-boot-tools逐个说明这些包的作用包名用途build-essentialgcc、make 等编译基础工具集合libncurses5-devmenuconfig 图形界面依赖flex / bison词法/语法分析器用于 DTC 编译器编译bc内核编译过程中需要用到数学计算libssl-dev内核模块签名所需libelf-dev处理 ELF 文件格式u-boot-tools提供mkimage工具生成 uImage1.2 安装交叉编译器ARM 嵌入式开发需要在 x86 PC 上编译出 ARM 指令集的代码这需要交叉编译工具链。推荐 Linaro 版本# 下载 Linaro 交叉编译器wgethttps://releases.linaro.org/components/toolchain/binaries/7.5-2019.12/arm-linux-gnueabihf/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz# 解压到 /optsudotar-xfgcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz-C/opt# 添加到 PATHexportPATH/opt/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin:$PATHechoexport PATH/opt/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin:$PATH~/.bashrc# 验证安装arm-linux-gnueabihf-gcc--version输出类似arm-linux-gnueabihf-gcc (Linaro GCC 7.5-2019.12) 7.5.0则表示安装成功。交叉编译器的命名规则前缀部分含义arm-ARM 32位架构linux-目标系统是 Linuxgnueabihf-glibc C库 硬件浮点(hard-float)二、获取内核源码# 从 kernel.org 下载 LTS 版本这里以 5.10 为例wgethttps://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.10.210.tar.xz# 解压tar-xflinux-5.10.210.tar.xzcdlinux-5.10.210解压后执行ls看一眼目录结构确认源码完整。三、配置内核这里使用 arm 架构下versatile_defconfig作为基础配置它是 QEMU 支持的一种 ARM 开发板配置方便验证# 加载默认配置makeARCHarmCROSS_COMPILEarm-linux-gnueabihf- versatile_defconfig# 进入图形化配置界面微调makeARCHarmCROSS_COMPILEarm-linux-gnueabihf- menuconfig在 menuconfig 中你至少可以确认以下设置General setup ---→ 确认Kernel compression mode为 GzipDevice Drivers ---→ 检查串口和块设备驱动是开启的File systems ---→ 确保 ext4 支持是[*]配置完成后保存退出.config文件就生成好了。四、编译内核4.1 第一步编译内核本体makeARCHarmCROSS_COMPILEarm-linux-gnueabihf- -j$(nproc)参数说明参数含义ARCHarm指定目标架构为 ARMCROSS_COMPILE...指定交叉编译器前缀-j$(nproc)并行编译使用所有CPU核心加速编译过程会输出大量信息正常情况下持续数分钟到十几分钟取决于你的CPU性能和内核配置大小。编译成功后会看到Kernel: arch/arm/boot/zImage is ready4.2 第二步编译设备树makeARCHarmCROSS_COMPILEarm-linux-gnueabihf- dtbs这会编译arch/arm/boot/dts/下所有的.dts文件生成对应的.dtb文件。4.3 第三步编译模块如果有选 M 的话makeARCHarmCROSS_COMPILEarm-linux-gnueabihf- modules五、编译产物详解编译完成后我们来盘点一下都生成了哪些文件arch/arm/boot/ ├── Image # 未压缩的原始内核镜像通常10MB ├── zImage # ★ 最常用的压缩内核镜像~3-5MB ├── dts/ │ ├── versatile-ab.dtb # 设备树二进制文件 │ └── versatile-pb.dtb └── compressed/ ├── vmlinux.bin.z # 压缩后的内核二进制 └── head.o # 解压启动代码产物说明用途vmlinux源码根目录下原始的 ELF 格式内核调试用不用于启动Image去掉了符号表和调试信息的裸二进制不含解压代码体积大zImageImage 经过 gzip 压缩 自解压头U-Boot 启动用的就是这个uImagezImage 加上 U-Boot 的 64 字节头老版本 U-Boot 使用需 mkimage*.dtb设备树二进制文件与 zImage 一起传给 U-Boot*.ko内核模块文件放在根文件系统的/lib/modules/zImage 的启动流程U-Boot 加载 zImage/ └── 头部自解压代码先执行 └── 解压出 Image └── 跳转到内核入口开始执行内核六、如何使用 QEMU 验证编译结果不需要物理开发板也能验证内核编译是否正确# 安装 QEMUsudoaptinstall-yqemu-system-arm# 用 QEMU 启动编译好的内核qemu-system-arm-Mversatilepb\-kernelarch/arm/boot/zImage\-dtbarch/arm/boot/dts/versatile-pb.dtb\-nographic\-appendconsolettyAMA0如果一切正常你会看到内核启动日志最终停在Kernel panic - not syncing: VFS: Unable to mount root fs on unknown-block(0,0)这个Kernel panic是正常的——因为我们没有提供根文件系统。内核能启动到这一步说明编译完全正确。七、编译常见错误与解决错误1arm-linux-gnueabihf-gcc: command not found原因交叉编译器未安装或未加入 PATHwhicharm-linux-gnueabihf-gcc# 检查是否在 PATH 中exportPATH/opt/xxx/bin:$PATH# 手动添加错误2fatal error: openssl/bio.h: No such file or directory原因缺少 libssl-devsudoaptinstalllibssl-dev错误3scripts/dtc/yamltree.c:17:10: fatal error: yaml.h: No such file or directory原因缺少 libyaml-dev内核 5.x 设备树校验需要sudoaptinstalllibyaml-dev错误4CONFIG_CC_STACKPROTECTOR_STRONG相关编译失败解决方案在 menuconfig 中关闭该选项General setup --- [ ] Stack Protector buffer overflow detection错误5multiple definition of yylloc解决方案内核版本太新交叉编译器太老。降级内核或升级交叉编译器。八、编译优化技巧8.1 使用 ccache 加速二次编译sudoaptinstallccacheexportCCccache arm-linux-gnueabihf-gccmakeARCHarmCROSS_COMPILEarm-linux-gnueabihf- -j$(nproc)第一次编译速度和原来一样但从第二次开始ccache 会命中缓存速度能提升 5~10 倍。8.2 只编译特定文件改了一个.c文件不想全量重编直接用# 只编译并链接 drivers/gpio/gpiolib.omakeARCHarmCROSS_COMPILEarm-linux-gnueabihf- drivers/gpio/gpiolib.o总结从环境搭建到 zImage 生成Linux 内核编译的全过程就这些步骤装交叉编译器 → 下源码 → 加载配置 → menuconfig 微调 → make 编译 → 拿到 zImage 和 dtb。虽然中间可能遇到依赖和版本兼容问题但只要理清流程99% 的错误都能通过查日志和补装依赖解决。
