Ubuntu20.04下用Make编译含Linux内核头文件程序报错求助

核心问题分析 #

1. 直接gcc编译找不到头文件：纯路径问题。Linux内核头文件默认不在GCC的默认搜索路径中，必须手动通过-I参数指定内核头文件的根目录。
2. Makefile编译出现重定义/成员缺失错误：路径+编译环境冲突的双重问题。内核头文件（如<linux/skbuff.h>）依赖内核专属的预定义宏（如__KERNEL__）和编译环境，直接与用户态头文件（如<stdio.h>）混编时，会触发宏冲突（比如struct pt_regs在用户态和内核态的定义不一致），同时内核结构的设计依赖内核运行环境，用户态直接引用会出现成员不存在的问题。

另外需要明确：内核模块不能使用用户态标准库（如<stdio.h>），内核有自己的打印机制printk()；如果是用户态程序，不应直接引用内核专属头文件（如<linux/skbuff.h>），这类头文件仅用于内核模块开发，用户态程序需通过内核提供的用户态接口（如netlink）与内核交互。

环境配置方案 #

方案1：Linux内核模块开发（正确场景） #

如果你的代码是内核模块，需移除<stdio.h>，改用内核API，配置如下：

模板Makefile

# 指定要编译的内核模块对象
obj-m += your_module.o
# 内核编译树路径，自动匹配当前系统内核版本
KDIR := /lib/modules/$(shell uname -r)/build
# 当前工作目录
PWD := $(shell pwd)

# 编译内核模块
all:
	make -C $(KDIR) M=$(PWD) modules

# 清理编译产物
clean:
	make -C $(KDIR) M=$(PWD) clean

说明：该Makefile调用内核自带的编译系统，自动处理内核头文件路径、预定义宏和编译选项，彻底避免环境冲突。

VS Code 智能提示配置（c_cpp_properties.json）

在.vscode目录下创建该文件，配置内核头文件路径和专属宏：

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/**",
                "/lib/modules/5.15.0-69-generic/build/include/**",
                "/lib/modules/5.15.0-69-generic/build/arch/x86/include/**"
            ],
            "defines": [
                "__KERNEL__",
                "MODULE"
            ],
            "compilerPath": "/usr/bin/gcc",
            "cStandard": "gnu11",
            "cppStandard": "gnu++14",
            "intelliSenseMode": "linux-gcc-x64"
        }
    ],
    "version": 4
}

方案2：用户态程序开发（需内核相关定义） #

如果是用户态程序，不建议直接引用内核专属头文件。若特殊需求必须引用，需手动隔离编译环境：

模板Makefile

CC := gcc
# 内核头文件根目录
KERNEL_INCLUDE := /lib/modules/5.15.0-69-generic/build/include
# 编译选项：指定头文件路径，定义内核专属宏，取消用户态宏
CFLAGS := -Wall -I$(KERNEL_INCLUDE) -D__KERNEL__ -DMODULE -U__USER__

# 编译用户态程序
all: your_program

your_program: your_program.c
	$(CC) $(CFLAGS) -o $@ $^

# 清理产物
clean:
	rm -f your_program

注意：这种方式仅能解决编译层面的冲突，内核结构的实际功能在用户态无法正常工作，仅适用于读取结构定义的场景。

VS Code 智能提示配置（c_cpp_properties.json）

{
    "configurations": [
        {
            "name": "Linux",
            "includePath": [
                "${workspaceFolder}/**",
                "/usr/include/**",
                "/lib/modules/5.15.0-69-generic/build/include/**"
            ],
            "defines": [
                "__KERNEL__",
                "MODULE"
            ],
            "compilerPath": "/usr/bin/gcc",
            "cStandard": "gnu11",
            "cppStandard": "gnu++14",
            "intelliSenseMode": "linux-gcc-x64"
        }
    ],
    "version": 4
}

内容的提问来源于stack exchange，提问作者akastack