C / C++ / 系统课时

把函数拆到多个源文件

把函数拆到多个源文件

当一个 C 程序从几十行增长到几百行,把所有函数都塞进 main.c 会很难维护。本课把一个加法函数拆成头文件、实现文件和入口文件,并用 GCC 完成编译与链接,建立“声明供别人使用、实现放在独立源文件、最终由链接器组合”的基本项目结构。

学习目标

  • 区分 .h 头文件中的声明与 .c 源文件中的函数实现。
  • 理解 #include 的作用,以及为什么实现文件也应包含自己的头文件。
  • 用 GCC 编译并链接多个源文件,验证拆分后的程序可正常运行。

先明确三个文件的职责

这个最小项目包含三个文件:

  • math_utils.h:公开函数声明,告诉其他源文件“这个函数怎样调用”。
  • math_utils.c:保存函数实现。
  • main.c:程序入口,通过头文件获取声明并调用函数。

#include "math_utils.h" 本质上是在预处理阶段把头文件内容引入当前翻译单元。头文件不是“自动编译的实现文件”,真正参与编译的是 .c 源文件。

头文件、源文件与编译链接关系

写头文件和实现文件

先创建 math_utils.h。头文件只暴露调用方需要知道的接口,并使用 include guard 防止同一翻译单元中重复包含:

c
#ifndef MATH_UTILS_H
#define MATH_UTILS_H

int add(int a, int b);

#endif

这是声明文件片段,不会独立运行。它会被 main.c 和 math_utils.c 通过 #include 引入,生效结果是两边都使用同一份函数签名。

再创建 math_utils.c:

c
#include "math_utils.h"

int add(int a, int b) {
    return a + b;
}

这是可编译的实现文件片段,需要与包含 main 函数的源文件一起构建。实现文件主动包含自己的头文件很重要:如果函数定义的参数或返回类型与声明不一致,编译器更容易及时发现问题。

在入口文件中调用函数

创建 main.c:

c
#include <stdio.h>
#include "math_utils.h"

int main(void) {
    int result = add(7, 5);
    printf("7 + 5 = %d\n", result);
    return 0;
}

预期输出(与 math_utils.c 一起编译并链接后):

text
7 + 5 = 12

main.c 不需要知道 add 的实现细节,只需要通过头文件知道函数签名。这种分离让调用方依赖稳定接口,而实现可以在不改变接口的前提下独立修改。

编译并链接多个源文件

最直接的方式是把两个 .c 文件一起交给 GCC:

bash
gcc -Wall -Wextra -std=c11 main.c math_utils.c -o app && ./app

预期输出:

text
7 + 5 = 12

这条命令内部会完成“分别编译源文件,再链接目标文件”的过程。为了看清两个阶段,也可以拆成:

bash
gcc -Wall -Wextra -std=c11 -c main.c -o main.o
gcc -Wall -Wextra -std=c11 -c math_utils.c -o math_utils.o
gcc main.o math_utils.o -o app
./app

预期输出:

text
7 + 5 = 12

-c 表示只编译、不链接,所以前两条命令生成 .o 目标文件;最后一条命令才把目标文件组合成可执行程序。

include 不等于把 .c 文件粘进来

调用方应该包含头文件,而不是写 #include "math_utils.c"。直接包含 .c 文件会把实现文本硬塞进当前翻译单元,容易导致重复定义,也破坏独立编译的边界。

当项目继续增长时,可以让多个 .c 文件各自负责一组功能,再用对应 .h 文件暴露公共接口。判断是否拆分的简单标准是:调用者只需要知道“怎么调用”,不需要看到“怎么实现”;满足这个条件的函数就很适合放进独立源文件。

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

目录与阅读设置

阅读设置

17

记录一个想法

把函数拆到多个源文件

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

登录哪都通