C / C++ / 系统课时

用 GCC 编译多个源文件

用 GCC 编译多个源文件

当程序拆成多个 .c 文件后,GCC 不再只是“把一个文件变成程序”。这篇用一个最小计算示例跑通编译、链接和执行,并说明为什么函数明明已经写了,仍可能在链接阶段报错。

学习目标

  • 能用 GCC 分别编译多个源文件并完成链接
  • 能区分编译阶段与链接阶段各自产生的问题
  • 能根据 undefined reference、重复定义等信息缩小排查范围

从三个文件开始

多文件项目通常把“声明”放在头文件,把“实现”放在源文件,再由其他源文件包含头文件。下面三个文件共同组成一个完整程序,因此每段都是片段示例,需放在同一目录后一起编译。

片段示例:calc.h 只声明可被其他源文件调用的函数。

c
#ifndef CALC_H
#define CALC_H

int add(int left, int right);

#endif

片段示例:calc.c 提供 add 的实际定义。

c
#include "calc.h"

int add(int left, int right) {
    return left + right;
}

片段示例:main.c 通过头文件获得函数声明,再调用 add。

c
#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 链接。这样可以直接看到两个阶段的边界。

bash
gcc -Wall -Wextra -c main.c calc.c
gcc main.o calc.o -o app
./app

预期输出

text
7 + 5 = 12

第一条命令成功后会得到 main.o 和 calc.o,通常不会打印内容;第二条命令把目标文件中的符号引用和定义连接起来,生成 app。也可以直接执行 gcc main.c calc.c -o app,只是分两步更适合学习和排错。

GCC 多文件从源文件到可执行文件的编译链接流程

链接错误通常意味着什么

如果省略 calc.o,main.o 中仍保留“需要一个 add”的引用,但链接器找不到对应定义,因此会出现包含 undefined reference to 'add' 或同义措辞的诊断。它与语法错误不同:main.c 已经成功编译,失败发生在目标文件合并阶段。

常见来源可以按符号关系判断:

  • undefined reference / undefined symbol:实现文件没有参与链接、库顺序或库参数不正确,或声明与定义名称不一致。
  • multiple definition:同一个非 static 全局函数或全局变量在多个目标文件中被重复定义。
  • 编译阶段报“未声明”或类型不匹配:优先检查头文件是否包含、函数声明是否一致,而不是先查链接命令。

多文件编译时的最小检查顺序

先确认每个 .c 文件都能单独通过 gcc -c,再确认最终链接命令包含所有需要的目标文件或库。若改过头文件中的函数签名,最好重新编译依赖它的源文件,避免旧目标文件继续参与链接。

当项目继续增大时,Makefile 或其他构建系统会自动管理“哪些源文件需要重编译”,但底层仍是同一件事:源文件先变成目标文件,目标文件和库再被链接成最终程序。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 GCC 编译多个源文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通