1. Makefile 基础入门：什么是 Makefile、为什么需要 Makefile、核心三要素

说实话，我刚开始做嵌入式开发那会儿，对 Makefile 是有点抵触的。总觉得「不就是编译代码吗？我一条条敲 gcc 命令不就行了？」直到有一次，我负责一个包含 200 多个源文件的物联网网关项目……

嗯，那次经历让我彻底服气了。每次修改一个 .c 文件，我得手动记着哪些文件需要重新编译。有一次漏掉了一个依赖，结果调试了整整两天，最后发现是链接了旧的目标文件。从那以后，我老老实实开始学 Makefile。

1.1 什么是 Makefile？

说白了，Makefile 就是一个自动化构建脚本。它告诉编译器：先编译什么、后编译什么、什么时候需要重新编译。

你想想看，一个嵌入式项目少则几十个源文件，多则上千个。如果每次改一行代码都要全量编译，那大部分时间都浪费在等待上了。Makefile 的核心价值就在于——增量编译。它只重新编译那些真正发生变化的文件，然后重新链接。

1.2 为什么需要 Makefile？

我见过不少新手工程师，项目初期就几个 .c 文件，觉得 Makefile 是多余的。但项目一旦膨胀到几十个文件，问题就来了：

• 依赖管理混乱——改了头文件，忘了重新编译所有依赖它的 .c 文件
• 编译命令冗长——每次都要敲一长串 gcc 参数，容易出错
• 跨平台移植困难——换一个编译器或开发板，所有命令要重写
• 无法并行编译——单线程编译，白白浪费多核 CPU 的性能

我曾经接手过一个项目，前任工程师把所有编译命令写在一个 shell 脚本里。每次编译都要跑十几分钟，而且没有任何增量编译机制。我花了两天时间改写成 Makefile，编译时间从 15 分钟降到了 30 秒。这就是 Makefile 的价值。

对比项	手动编译	Makefile 编译
增量编译	不支持，每次全量	自动检测变化，只编译修改部分
并行编译	需手动拆分	make -j 自动并行
依赖管理	人工维护，易遗漏	自动推导头文件依赖
跨平台	每个平台一套脚本	变量控制，一套 Makefile 多平台
可维护性	差，命令散落各处	好，集中管理构建规则

1.3 Makefile 的核心三要素

Makefile 的语法其实很简单，核心就三个东西：目标（target）、依赖（prerequisites）、命令（recipe）。我习惯把它们叫做「铁三角」。

1.3.1 目标（Target）

目标就是你要生成的东西。可以是一个可执行文件、一个 .o 文件，也可以是一个伪目标（比如 clean、all）。

# 最简单的目标
hello: main.o utils.o
    gcc -o hello main.o utils.o

# 伪目标
.PHONY: clean
clean:
    rm -f *.o hello

注意看，hello 是最终目标，clean 是伪目标。伪目标不生成文件，只是执行一组命令。我刚开始学的时候经常忘记加 .PHONY，结果目录下如果有个叫 clean 的文件，make clean 就永远不会执行了……这个坑我踩过。

1.3.2 依赖（Prerequisites）

依赖就是构建目标之前需要先准备好的东西。Makefile 的智能之处就在这里——它会检查依赖文件的时间戳。如果任何一个依赖比目标新，就重新构建目标。

# main.o 依赖 main.c 和 defs.h
main.o: main.c defs.h
    gcc -c main.c -o main.o

# utils.o 依赖 utils.c 和 defs.h
utils.o: utils.c defs.h
    gcc -c utils.c -o utils.o

1.3.3 命令（Recipe）

命令就是如何从依赖生成目标的具体操作。每条命令前面必须有一个 Tab 键，不能用空格代替。这是 Makefile 最坑的地方，没有之一。

# 注意：命令前的缩进必须是 Tab
target: prerequisites
    command1
    command2
    command3

我曾经帮一个同事调试 Makefile，看了半天语法都没问题，就是报错。最后发现他用的是 8 个空格而不是 Tab。这个错误太常见了，我建议你在编辑器里设置「显示空白字符」，一眼就能看出来。

1.4 一个完整的入门示例

咱们来看一个完整的例子。假设项目有三个文件：main.c、utils.c、utils.h。

# 最简单的 Makefile
hello: main.o utils.o
    gcc -o hello main.o utils.o

main.o: main.c utils.h
    gcc -c main.c -o main.o

utils.o: utils.c utils.h
    gcc -c utils.c -o utils.o

.PHONY: clean
clean:
    rm -f *.o hello

执行流程是这样的：

1. 输入 make，make 程序找到第一个目标 hello
2. 检查 hello 的依赖 main.o 和 utils.o 是否存在
3. 如果 main.o 不存在，或者 main.c/utils.h 比它新，就重新编译 main.o
4. 同理处理 utils.o
5. 所有依赖就绪后，链接生成 hello

1.5 知识结构图

下面这张图把 Makefile 的核心逻辑串起来了，我建议你多看几遍：

1.6 避坑指南

最后分享几个我这些年踩过的坑：

• Tab 和空格——Makefile 的命令行必须用 Tab 缩进，这是新手最常见的错误。我建议在 vim 里设置 set list，Tab 会显示为 ^I，一目了然。
• 伪目标要声明——凡是不会生成同名文件的 target，都要加 .PHONY 声明。否则目录下如果有同名文件，make 会认为目标已是最新。
• 依赖要写全——头文件依赖是 Makefile 最容易遗漏的部分。漏掉一个头文件依赖，改了头文件却不会触发重新编译，这种 bug 极难排查。
• 命令的 shell 环境——每条命令都在独立的 shell 中执行。如果你写了 cd dir 然后 make，第二条命令不会在 dir 目录下执行。需要用 && 连接或者写成一行。

好了，这一章的内容就到这里。Makefile 的核心三要素其实不复杂，但它们是整个 Makefile 体系的基石。后面的所有高级技巧——变量替换、模式规则、自动依赖生成——都是建立在这个基础之上的。