C / C++ / 系统课时
把函数拆到不同源文件
把函数拆到不同源文件
当一个 C 程序出现多个相对独立的功能时,可以把函数实现移动到不同 .c 文件,再用头文件声明公开接口。本节完成一个最小多文件项目,并用编译命令验证多个编译单元如何在链接阶段组合成一个可执行程序。
学习目标
- 把函数声明放进头文件、函数定义放进独立源文件
- 在调用方通过
#include使用共享接口 - 使用编译器一次构建多个源文件并验证运行结果
先确定文件职责
我们把加法函数从 main.c 拆到 math_utils.c,同时创建 math_utils.h 保存公开声明。三个文件的职责分别是:main.c 负责程序入口,math_utils.c 负责实现,math_utils.h 负责告诉其他编译单元“这个函数怎样调用”。

创建共享头文件
math_utils.h 只放调用方需要知道的声明,并用 include guard 防止同一翻译单元里被重复包含。
#ifndef MATH_UTILS_H
#define MATH_UTILS_H
int add(int a, int b);
#endif这是配置接口的片段示例,文件名为 math_utils.h。它本身不单独运行;生效方式是在需要调用 add 的源文件中包含该头文件,并让编译器检查调用处看到的函数签名。
在独立源文件中实现函数
math_utils.c 包含自己的头文件,可以让编译器顺便检查“声明”和“定义”是否保持一致。
#include "math_utils.h"
int add(int a, int b) {
return a + b;
}这是片段示例,依赖同目录下的 math_utils.h。实现文件不需要 main,因为它只是整个程序的一个编译单元。
调用方 main.c 只依赖公开接口,不需要知道 add 的具体实现。
#include <stdio.h>
#include "math_utils.h"
int main(void) {
int result = add(7, 5);
printf("result = %d\n", result);
return 0;
}这是片段示例,依赖 math_utils.h 和 math_utils.c。三个文件准备好后,再一起参与构建。
编译并链接多个源文件
在 Linux、macOS 或安装了 GCC 的环境中,可以直接把两个 .c 文件交给 gcc。编译器会分别编译它们,并在随后执行链接。
gcc -std=c11 -Wall -Wextra -pedantic main.c math_utils.c -o app
./app预期输出
result = 12如果使用 Windows PowerShell 且 GCC 生成的是 app.exe,运行命令通常改为 ./app.exe,输出内容不变。
也可以显式观察“先编译、后链接”的过程:
gcc -std=c11 -Wall -Wextra -pedantic -c main.c -o main.o
gcc -std=c11 -Wall -Wextra -pedantic -c math_utils.c -o math_utils.o
gcc main.o math_utils.o -o app
./app预期输出
result = 12这里 -c 表示只编译、不链接。第一步生成 main.o,第二步生成 math_utils.o,最后一步把两个目标文件链接成可执行程序。实际目标文件扩展名会因工具链和平台不同而变化。
常见错误看链接阶段
如果忘记把 math_utils.c 加入构建,只编译 main.c,调用处因为已经看到头文件声明,编译可能通过,但链接器找不到 add 的定义,最终会出现“undefined reference”或同类未解析符号错误。
gcc -std=c11 -Wall -Wextra -pedantic main.c -o app预期结果
链接失败:链接器无法找到 add 的函数定义。具体错误文本会因编译器和平台而不同。这类错误说明“声明存在,但定义没有参与链接”。排查时先确认实现函数所在的 .c 文件是否被加入编译命令,再检查函数名和参数签名是否一致。
把声明集中到头文件、把实现放入对应源文件、让所有需要的 .c 文件参与构建,是 C 多文件项目最基本也最重要的协作方式。