gcc不支持跨目录递归编译，需显式指定所有源文件和-i头文件路径，如gcc -iinclude/ src/.c lib/.c -o app；链接时需用-l和-l指定库路径与名称；推荐使用makefile或cmake管理复杂项目。
gcc 本身不支持跨目录递归编译
直接用 gcc *.c 或 gcc src/*.c lib/*.c 看似可行，但实际会失败：如果 src/ 里的 main.c 包含 #include "utils.h"，而 utils.h 在 include/ 目录下，gcc 默认只在当前目录找头文件，找不到就报 fatal error: utils.h: No such file or directory。
根本原因：gcc 是单文件驱动的工具，它不解析目录结构、不自动发现依赖、也不管理构建顺序。所谓“编译多个目录”，本质是告诉它：哪些源文件要参与编译 + 哪些路径要用来找头文件和库。
必须显式指定所有 .c 文件和 -I 路径
假设项目结构如下：
project/ ├── src/ │ ├── main.c │ └── io.c ├── lib/ │ └── crypto.c ├── include/ │ ├── io.h │ └── crypto.h └── Makefile
正确做法是手动列出所有 .c 文件，并用 -I 添加头文件搜索路径：
gcc -Iinclude/ src/main.c src/io.c lib/crypto.c -o app- 如果源文件太多，可用 shell 展开：
gcc -Iinclude/ src/*.c lib/*.c -o app（前提是各目录下只有源码，无其他.h或临时文件） -
-I可多次使用：gcc -Iinclude/ -Ithird_party/openssl/include/ ... - 注意：
-I路径是相对于执行命令时的当前工作目录，不是相对于gcc本身或源文件位置
链接阶段要处理不同目录下的 .o 或 .a 文件
如果你已分别编译出目标文件（比如 src/main.o、lib/crypto.o），链接时路径也得写全：
gcc src/main.o lib/crypto.o -o app- 若用了静态库
lib/libutils.a，需加-L和-l：gcc src/main.o -Llib/ -lutils -o app -
-Llib/告诉链接器去lib/目录下找库；-lutils实际查找的是libutils.a或libutils.so - 顺序很重要：
gcc a.o b.o -lfoo中，-lfoo必须放在它所依赖的目标文件之后，否则可能报 undefined reference
真正可靠的做法：别硬扛，用 make 或 cmake
手写长命令容易漏文件、错路径、参数顺序出错，尤其当目录变多、依赖嵌套时。比如新增 drivers/uart.c，你得改三处：gcc 命令、-I、可能还有 -L。
最小可行 Makefile 示例：
CC = gcc CFLAGS = -Iinclude/ -Wall -Werror SRCS = src/main.c src/io.c lib/crypto.c OBJS = $(SRCS:.c=.o) TARGET = app $(TARGET): $(OBJS) $(CC) $^ -o $@ %.o: %.c $(CC) $(CFLAGS) -c $ <p>运行 <code>make</code> 就自动编译所有源码并链接，增删文件只需改 <code>SRCS</code> 行。比反复敲 <code>gcc</code> 命令安全得多。</p> <p>跨目录问题最常被忽略的点不是语法，而是头文件路径的相对性、链接顺序、以及目标文件生成位置是否一致——这些在手工命令里全靠人盯，一疏忽就是 <code>undefined reference</code> 或 <code>file not found</code>，修起来比写 Makefile 还费时间。</p>
