C / C++ / 系统课时
用 Make 管理增量构建
用 Make 管理增量构建
多文件 C 工程最常见的低效做法是每次都重新编译全部源码。Make 的核心不是“替你执行 gcc”,而是根据目标、依赖关系和文件时间戳判断哪些产物已经过期。本课用一个最小工程写出可重复的增量构建,并让头文件变化也能触发正确重编译。
学习目标
- 能用目标、普通依赖和顺序依赖描述 C 工程的构建关系。
- 能使用模式规则与
$@、$<、$^自动变量减少重复命令。 - 能借助
-MMD -MP自动维护头文件依赖,并验证增量构建是否准确。
建立工程与依赖关系
工程包含两个源文件和一个公共头文件:main.c 调用 calc.c 提供的 add。先创建最小源码。
mkdir -p make-demo/include make-demo/src
cd make-demo
cat > include/calc.h <<'EOF'
#ifndef CALC_H
#define CALC_H
int add(int a, int b);
#endif
EOF
cat > src/calc.c <<'EOF'
#include "calc.h"
int add(int a, int b) {
return a + b;
}
EOF
cat > src/main.c <<'EOF'
#include <stdio.h>
#include "calc.h"
int main(void) {
printf("%d\n", add(20, 22));
return 0;
}
EOF预期结果:命令无输出,并创建 include/calc.h、src/calc.c 与 src/main.c。
Make 判断一个目标是否需要重建时,主要看两件事:目标是否存在,以及是否有依赖文件比目标更新。因此真正要维护的是依赖图,而不是一串固定执行步骤。

编写模式规则和自动变量
下面的 Makefile 把编译选项、对象列表和规则集中管理。$@ 表示当前目标,$< 表示第一个普通依赖,$^ 表示全部普通依赖;模式规则 build/%.o: src/%.c 可以同时覆盖两个 .c 文件。
CC := gcc
CPPFLAGS := -Iinclude
CFLAGS := -std=c11 -Wall -Wextra -O2 -MMD -MP
TARGET := build/app
OBJ := build/main.o build/calc.o
DEP := $(OBJ:.o=.d)
.PHONY: all clean
all: $(TARGET)
$(TARGET): $(OBJ)
$(CC) $^ -o $@
build/%.o: src/%.c | build
$(CC) $(CPPFLAGS) $(CFLAGS) -c $< -o $@
build:
mkdir -p $@
-include $(DEP)
clean:
rm -rf build这是完整配置文件,不单独产生控制台输出。把它保存为项目根目录的 Makefile 后,执行 make 即可验证。命令行必须由 Tab 开头;如果把 Tab 换成普通空格,传统 Makefile 语法会报 missing separator。
| build 是顺序依赖:它保证编译前目录存在,但不会因为目录时间戳变化就让所有对象文件失效。-MMD -MP 会在编译时生成与目标文件同目录的 .d 文件,-include 再把真实头文件依赖纳入下一次构建。
执行首次构建并验证
make
./build/app预期输出
mkdir -p build
gcc -Iinclude -std=c11 -Wall -Wextra -O2 -MMD -MP -c src/main.c -o build/main.o
gcc -Iinclude -std=c11 -Wall -Wextra -O2 -MMD -MP -c src/calc.c -o build/calc.o
gcc build/main.o build/calc.o -o build/app
42首次构建时目标都不存在,所以两个源文件都会编译,随后执行一次链接。实际输出中的编译器路径或默认附加参数可能因环境而不同,但依赖顺序应一致。
验证真正的增量构建
什么都不修改时再次执行 make,Make 会发现目标文件都不比依赖旧,因此不会重新编译。
make预期输出通常为
make: Nothing to be done for 'all'.提示文本会受 Make 版本和系统语言影响,关键现象是没有新的 gcc 命令。接着只修改 src/calc.c 的时间戳,应该只重编译 calc.o,然后重新链接最终程序。
touch src/calc.c
make预期输出
gcc -Iinclude -std=c11 -Wall -Wextra -O2 -MMD -MP -c src/calc.c -o build/calc.o
gcc build/main.o build/calc.o -o build/app最后修改公共头文件可以检查自动依赖是否生效。
touch include/calc.h
make预期输出
gcc -Iinclude -std=c11 -Wall -Wextra -O2 -MMD -MP -c src/main.c -o build/main.o
gcc -Iinclude -std=c11 -Wall -Wextra -O2 -MMD -MP -c src/calc.c -o build/calc.o
gcc build/main.o build/calc.o -o build/app如果头文件变化后对象文件没有重编译,优先检查 .d 文件是否生成、-include $(DEP) 是否存在,以及编译命令是否真的包含 -MMD。把依赖关系描述准确后,Make 才能同时做到“该重建时一定重建,不该重建时绝不浪费时间”。