C / C++ / 系统课时

用 Make 管理增量构建

用 Make 管理增量构建

多文件 C 工程最常见的低效做法是每次都重新编译全部源码。Make 的核心不是“替你执行 gcc”,而是根据目标、依赖关系和文件时间戳判断哪些产物已经过期。本课用一个最小工程写出可重复的增量构建,并让头文件变化也能触发正确重编译。

学习目标

  • 能用目标、普通依赖和顺序依赖描述 C 工程的构建关系。
  • 能使用模式规则与 $@、$<、$^ 自动变量减少重复命令。
  • 能借助 -MMD -MP 自动维护头文件依赖,并验证增量构建是否准确。

建立工程与依赖关系

工程包含两个源文件和一个公共头文件:main.c 调用 calc.c 提供的 add。先创建最小源码。

bash
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 判断一个目标是否需要重建时,主要看两件事:目标是否存在,以及是否有依赖文件比目标更新。因此真正要维护的是依赖图,而不是一串固定执行步骤。

Make 增量构建依赖图

编写模式规则和自动变量

下面的 Makefile 把编译选项、对象列表和规则集中管理。$@ 表示当前目标,$< 表示第一个普通依赖,$^ 表示全部普通依赖;模式规则 build/%.o: src/%.c 可以同时覆盖两个 .c 文件。

makefile
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 再把真实头文件依赖纳入下一次构建。

执行首次构建并验证

bash
make
./build/app

预期输出

text
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 会发现目标文件都不比依赖旧,因此不会重新编译。

bash
make

预期输出通常为

text
make: Nothing to be done for 'all'.

提示文本会受 Make 版本和系统语言影响,关键现象是没有新的 gcc 命令。接着只修改 src/calc.c 的时间戳,应该只重编译 calc.o,然后重新链接最终程序。

bash
touch src/calc.c
make

预期输出

text
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

最后修改公共头文件可以检查自动依赖是否生效。

bash
touch include/calc.h
make

预期输出

text
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 才能同时做到“该重建时一定重建,不该重建时绝不浪费时间”。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Make 管理增量构建

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

登录哪都通