C语言编译时如何包含不同目录下的自定义头文件

原命令错误点 #

你的编译命令存在两个基础用法错误，是导致报错的核心原因：

• -I 参数的作用是指定头文件搜索目录，后面必须跟目录路径，不能直接拼接.c源文件路径，你写的-I .../headers/myHeader.c完全不符合参数规则
• -c 参数的作用是让编译器只执行编译步骤、不做链接，生成可执行文件时携带该参数，不会完成跨文件的符号关联，自然找不到其他源文件里定义的函数

头文件搜索规则 #

GCC 处理#include引用时的搜索逻辑：

1. 先查找当前被编译的源文件所在目录
2. 再查找所有-I参数指定的自定义目录（按参数书写顺序查找）
3. 最后查找系统默认的头文件存储目录
   如果有多个自定义头文件目录，只要给每个目录单独加一个-I 目录路径参数即可，没有数量限制。

对应目录结构的正确编译方式 #

你给出的分层目录结构（项目根目录下存在headers、testing两个子文件夹）：

headers/
    include/
        myHeader.h
    myHeader.c
testing/
    test.c

首先建议调整源文件里的头文件引用写法：不管是myHeader.c还是test.c，直接写#include "myHeader.h"即可，不要在include语句里写嵌套相对路径，避免因为工作目录变化导致找不到头文件。

在项目根目录（即headers、testing文件夹的上一级目录）打开终端执行编译，可选两种方式：

方式1：一步编译链接生成可执行文件 #

适合文件少的小项目，去掉-c参数，列全所有参与编译的.c源文件，用-I指定头文件所在目录即可：

gcc -I./headers/include ./headers/myHeader.c ./testing/test.c -o test.exe

如果后续新增其他头文件目录，比如新增utils/include目录存放工具类头文件，直接追加参数即可：

gcc -I./headers/include -I./utils/include ./headers/myHeader.c ./utils/string_utils.c ./testing/test.c -o test.exe

方式2：分步骤编译（适合中大型项目） #

大项目可以先把每个源文件单独编译为.o中间目标文件，修改单个文件时不用全量重编，最后统一链接：

# 单独编译myHeader.c为目标文件，这一步才需要用-c参数
gcc -c -I./headers/include ./headers/myHeader.c -o myHeader.o
# 单独编译test.c为目标文件
gcc -c -I./headers/include ./testing/test.c -o test.o
# 把所有目标文件链接为可执行文件，这一步不需要-I和-c参数
gcc myHeader.o test.o -o test.exe

注意事项 #

• 头文件（.h）里只放函数声明、宏定义、类型定义，不要写具体的函数实现（inline静态函数除外），避免链接时出现重复定义错误
• 写-I参数时注意相对路径是相对于你执行编译命令时的终端工作目录，不确定的话可以写头文件目录的绝对路径
• 所有实现了函数的.c源文件，都要加入编译列表，否则链接阶段会报未定义函数错误

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