多文件编译失败90%是链接问题：undefined reference 表示符号未定义，需检查声明/定义匹配和编译命令；multiple definition 表示符号重复定义，应避免头文件中定义变量或函数；用 gcc -c 分离编译可精确定位阶段。
直接编译多个 .c 文件失败，90% 的问题出在链接阶段，而不是语法本身——你看到的报错往往不是“哪行写错了”，而是“哪个定义找不到了”或“哪个定义撞上了”。先别急着改代码，按阶段查。
看错误信息里有没有 undefined reference to
这是最典型的多文件链接失败信号。它意味着：某个函数或变量在某个 .c 文件里被调用了（extern 声明或直接使用），但所有参与链接的 .o 文件和库中，都没有它的实际定义（即没有对应的 int func() { ... } 或 int global_var = 0;）。
- 检查调用方是否漏写了
#include "xxx.h"，导致声明都没引入 - 检查实现方（比如
utils.c）是否真有该函数的完整定义，而不是只写了声明 - 确认编译命令里是否真的包含了实现方的源文件或目标文件：
gcc main.c utils.c -o app不能漏掉utils.c - 如果用了静态库（
.a），确保-lxxx放在命令末尾，且库名拼写正确（-lm不是-llibm）
看错误信息里有没有 multiple definition of
这说明同一个符号（函数名、全局变量名）在多个 .c 文件里被定义了两次以上。C 语言不允许“一个符号多个定义”，链接器会直接拒绝。
- 重点检查全局变量：不要在头文件里写
int counter = 0;，而应写extern int counter;，然后只在某一个.c文件里写int counter = 0; - 检查是否误把函数实现写进了头文件（
.h），又被多个.c包含，导致重复编译进多个.o - 用
nm file1.o file2.o | grep your_symbol看哪些文件里真定义了该符号（输出带C或D标记的行） - 临时加
static限制作用域（仅限调试用）：比如static void helper()可避免跨文件冲突，但会失去共享能力
用 gcc -c 分离编译再手动链接
跳过自动编译+链接一步到位的方式，能精准定位是编译阶段还是链接阶段出问题。
- 先单独编译每个源文件：
gcc -c main.c -o main.o、gcc -c utils.c -o utils.o - 检查是否都生成了
.o文件；如果某个.o没生成，说明那个文件有语法错误或头文件缺失 - 再手动链接：
gcc main.o utils.o -o app。这时报错就纯粹是链接问题，排除了单个文件编译干扰 - 加
-v参数看详细过程：gcc -v main.o utils.o -o app，能清楚看到ld实际调用了哪些库路径和选项
最容易被忽略的是：头文件里写了变量定义、函数实现，或者把 #include "xxx.h" 写成 #include <xxx.h></xxx.h> 导致找不到自建头文件。这些错误不会在单文件编译时报，但一合并就炸。动手前，先用 gcc -E 看预处理结果，确认头文件真被展开了。
