C / C++ / 系统课时
用 GCC 编译多个源文件
用 GCC 编译多个源文件
当程序拆成多个 .c 文件后,GCC 不再只是“把一个文件变成程序”。这篇用一个最小计算示例跑通编译、链接和执行,并说明为什么函数明明已经写了,仍可能在链接阶段报错。
学习目标
- 能用 GCC 分别编译多个源文件并完成链接
- 能区分编译阶段与链接阶段各自产生的问题
- 能根据
undefined reference、重复定义等信息缩小排查范围
从三个文件开始
多文件项目通常把“声明”放在头文件,把“实现”放在源文件,再由其他源文件包含头文件。下面三个文件共同组成一个完整程序,因此每段都是片段示例,需放在同一目录后一起编译。
片段示例:calc.h 只声明可被其他源文件调用的函数。
#ifndef CALC_H
#define CALC_H
int add(int left, int right);
#endif片段示例:calc.c 提供 add 的实际定义。
#include "calc.h"
int add(int left, int right) {
return left + right;
}片段示例:main.c 通过头文件获得函数声明,再调用 add。
#include <stdio.h>
#include "calc.h"
int main(void) {
int result = add(7, 5);
printf("7 + 5 = %d\n", result);
return 0;
}头文件让编译器知道函数签名,calc.c 中的定义则要在链接阶段真正加入最终程序。只有声明而没有被链接进来的定义,仍然无法生成可执行文件。
分开执行编译和链接
先用 -c 只编译,不链接;随后把两个目标文件交给 GCC 链接。这样可以直接看到两个阶段的边界。
gcc -Wall -Wextra -c main.c calc.c
gcc main.o calc.o -o app
./app预期输出
7 + 5 = 12第一条命令成功后会得到 main.o 和 calc.o,通常不会打印内容;第二条命令把目标文件中的符号引用和定义连接起来,生成 app。也可以直接执行 gcc main.c calc.c -o app,只是分两步更适合学习和排错。

链接错误通常意味着什么
如果省略 calc.o,main.o 中仍保留“需要一个 add”的引用,但链接器找不到对应定义,因此会出现包含 undefined reference to 'add' 或同义措辞的诊断。它与语法错误不同:main.c 已经成功编译,失败发生在目标文件合并阶段。
常见来源可以按符号关系判断:
- undefined reference / undefined symbol:实现文件没有参与链接、库顺序或库参数不正确,或声明与定义名称不一致。
- multiple definition:同一个非
static全局函数或全局变量在多个目标文件中被重复定义。 - 编译阶段报“未声明”或类型不匹配:优先检查头文件是否包含、函数声明是否一致,而不是先查链接命令。
多文件编译时的最小检查顺序
先确认每个 .c 文件都能单独通过 gcc -c,再确认最终链接命令包含所有需要的目标文件或库。若改过头文件中的函数签名,最好重新编译依赖它的源文件,避免旧目标文件继续参与链接。
当项目继续增大时,Makefile 或其他构建系统会自动管理“哪些源文件需要重编译”,但底层仍是同一件事:源文件先变成目标文件,目标文件和库再被链接成最终程序。