第二章 内核开发环境搭建：从零开始打造你的调试王国

说实话，很多初学者都栽在环境搭建这一步。我见过太多人，代码写得挺溜，结果连内核都编译不过，更别说调试了。这一章，我就带你一步步把整个环境搭起来。你想想看，一个稳定的开发环境，就像战士手里的枪——不趁手，怎么打仗？

2.1 内核源码获取：选对版本，少走弯路

我个人习惯用长期支持版（LTS）。为什么？因为稳定。我在项目中吃过亏，追新版本追到一半，API变了，整个驱动重写——那叫一个酸爽。

获取源码的方式有两种：

• 官网直接下载：https://www.kernel.org，选最新的LTS版本就行
• Git克隆：适合需要切分支、看历史提交的场景

# 我推荐的方式：下载tar包，干净利落
wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.1.76.tar.xz
tar -xf linux-6.1.76.tar.xz
cd linux-6.1.76

2.2 编译内核：第一次跑通，成就感满满

编译内核听起来高大上，其实就三步：配置、编译、安装。但每一步都有坑，我一个个说。

2.2.1 安装依赖

先确保你的系统装了必要的工具链。以Ubuntu为例：

sudo apt-get update
sudo apt-get install build-essential libncurses-dev bison flex libssl-dev libelf-dev

嗯，这里要注意——libelf-dev容易漏掉。我曾经因为这个折腾了一下午，编译到最后报错，才发现少了个包。

2.2.2 配置内核

配置内核有两种思路：

• 从零配置：make menuconfig，适合想深度定制的人
• 基于现有配置：复制当前系统的配置，省时省力

# 我一般用第二种，快
cp /boot/config-$(uname -r) .config
make olddefconfig  # 用默认值填充新选项

2.2.3 编译与安装

# 用-j参数加速，我一般设为核心数+1
make -j$(nproc)

# 安装模块和内核
sudo make modules_install
sudo make install

第一次编译大概要20-40分钟，取决于你的机器。这时候可以去泡杯咖啡。我习惯在编译时开个终端跑htop，看着CPU满载，心里踏实。

2.3 QEMU虚拟机调试环境搭建：这才是重头戏

为什么用QEMU？说白了，真机调试太危险。我刚开始做驱动时，一个空指针就把整个系统搞挂了，重启十几次。有了QEMU，随便崩，拍个快照就恢复。

2.3.1 安装QEMU

sudo apt-get install qemu-system-x86 qemu-utils

2.3.2 制作根文件系统

内核跑起来需要根文件系统。我推荐用Buildroot，轻量好用：

# 下载Buildroot
wget https://buildroot.org/downloads/buildroot-2023.11.tar.xz
tar -xf buildroot-2023.11.tar.xz
cd buildroot-2023.11

# 配置，选x86_64架构
make qemu_x86_64_defconfig
make -j$(nproc)

编译完会在output/images下生成rootfs.ext2。这就是你的虚拟硬盘。

2.3.3 启动QEMU

启动脚本我一般写成这样：

#!/bin/bash
qemu-system-x86_64 \
  -kernel /path/to/linux-6.1.76/arch/x86/boot/bzImage \
  -drive file=rootfs.ext2,format=raw \
  -append "root=/dev/sda console=ttyS0 nokaslr" \
  -nographic \
  -s -S

参数说明：

• -s：开启GDB调试端口（默认1234）
• -S：启动时暂停CPU，等GDB连上来
• nokaslr：关闭地址随机化，方便调试

2.4 内核模块开发基础：Hello World，但没那么简单

终于到写代码环节了。内核模块和用户态程序完全不同——没有main函数，入口是init_module，出口是cleanup_module。

2.4.1 第一个模块

// hello.c
#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/init.h>

static int __init hello_init(void)
{
    printk(KERN_INFO "Hello, Kernel! Module loaded.\n");
    return 0;
}

static void __exit hello_exit(void)
{
    printk(KERN_INFO "Goodbye, Kernel! Module unloaded.\n");
}

module_init(hello_init);
module_exit(hello_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Your Name");
MODULE_DESCRIPTION("A simple Hello World module");

2.4.2 Makefile写法

obj-m += hello.o

all:
    make -C /lib/modules/$(shell uname -r)/build M=$(PWD) modules

clean:
    make -C /lib/modules/$(shell uname -r)/build M=$(PWD) clean

2.4.3 编译与测试

make
# 生成 hello.ko

# 加载模块
sudo insmod hello.ko

# 查看内核日志
dmesg | tail
# 应该能看到 "Hello, Kernel! Module loaded."

# 卸载模块
sudo rmmod hello
dmesg | tail
# 看到 "Goodbye, Kernel! Module unloaded."

2.5 本章知识体系

下面这张图，是我梳理的整个环境搭建流程。你可以把它当成路线图，哪一步卡住了，回头看看就知道问题出在哪。

2.6 避坑指南：我踩过的那些雷

最后，分享几个我实际项目中遇到的坑，你遇到了能少走弯路：

• 模块签名问题：新内核默认开启模块签名，加载自己编译的模块会报错。解决方案：在BIOS里关掉Secure Boot，或者给模块签名。
• printk不输出：检查日志级别。我习惯在模块里用pr_info()，然后在宿主机用dmesg -w实时查看。
• QEMU网络不通：默认QEMU没配网络。调试模块不需要网络，但如果需要，可以用-netdev user参数。
• GDB连不上：确认QEMU启动时加了-s -S，并且没有其他程序占用1234端口。