📚 课程目录第2章 Makefile核心规则

2. Makefile核心规则

好，咱们直接进入正题。

Makefile 这东西，说白了就是一套「规则说明书」。你告诉 make 工具：我想生成什么，它依赖谁，以及怎么生成。就这么简单。

但越是简单的东西，越容易在细节上翻车。我见过不少同事，写了几年 Makefile，还在被「多了一个 Tab 键」这种问题折磨。嗯，今天咱们就把这些坑一个一个填平。

2.1 规则的基本语法结构

一条 Makefile 规则，长这样：

目标(target): 依赖(prerequisites)
<Tab>命令(command)

注意那个 <Tab>，它不是空格，不是 4 个空格，必须是 一个 Tab 字符。这是 Makefile 最坑的地方，没有之一。

举个例子：

hello: hello.c
    gcc -o hello hello.c

这里：

目标：hello，就是我们要生成的可执行文件
依赖：hello.c，生成 hello 需要这个源文件
命令：gcc -o hello hello.c，具体怎么编译

我个人习惯把命令写在一行，如果太长就用反斜杠 \ 换行：

hello: hello.c \
       utils.c
    gcc -o hello hello.c utils.c

2.2 规则的工作原理

Make 是怎么工作的？其实就三步：

检查目标是否存在。如果不存在，执行命令生成它。
检查依赖是否更新。如果依赖比目标新，重新生成目标。
递归检查。依赖本身也可能是另一个规则的目标，make 会先处理依赖。

说白了，就是「谁老了就重新造谁」。这个机制非常聪明，能避免不必要的重新编译。

我在项目中遇到过一个问题：有个同事改了头文件，但 make 没检测到，结果整个项目链接了旧的目标文件，调试了一下午才发现。后来我们加上了头文件依赖，才彻底解决。

核心逻辑：Make 通过比较「目标」和「依赖」的时间戳，来决定是否需要重新执行命令。

下面这张图，把整个流程画清楚了：

2.3 伪目标 .PHONY

你想想看，如果有一个目标叫 clean，它不生成任何文件，只是执行删除操作。但万一当前目录下恰好有一个叫 clean 的文件呢？

Make 会检查：clean 文件存在，而且没有依赖比它新，于是什么都不做。你的 rm 命令永远不会被执行。

这就是伪目标存在的意义。

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

加上 .PHONY 之后，make 就知道：clean 不是一个真正的文件，不管它存不存在，每次都执行命令。

我曾经踩过的坑：在一个大型项目中，有个同事把 all 也声明为伪目标，但 all 本身确实生成了一个叫 all 的中间文件。结果每次 make 都重新编译整个项目，浪费了半小时。所以，只有那些不生成同名文件的目标，才应该声明为 .PHONY。

常见的伪目标有：

伪目标	用途
`all`	默认目标，通常放在第一个，编译所有内容
`clean`	清理编译产物
`install`	安装程序到系统目录
`test`	运行测试用例

小技巧：我习惯把所有不生成文件的目标，统一放在文件末尾的 .PHONY 声明中：

.PHONY: all clean install test

这样一目了然，别人接手你的 Makefile 时也不会迷惑。

2.4 多目标与多依赖

一个规则可以有多个目标，也可以有多个依赖。用空格隔开就行：

main.o utils.o: defs.h
    # 这里注意：这条命令会对每个目标执行一次
    # 但通常我们不这么写，而是分开写

更常见的写法是：

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

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

每个 .o 文件都有自己的规则，依赖关系清晰。你想想看，如果所有 .o 都依赖同一个头文件，改一次头文件，所有 .o 都会重新编译。这就是增量编译的威力。

2.5 命令的注意事项

命令部分有几个细节，我建议你记住：

每行命令都在独立的 shell 中执行。所以 cd 命令只对当前行有效，下一行又回到原目录了。解决办法是用 && 连接，或者写在一行用分号隔开。
命令前加 @ 可以隐藏命令本身，只显示输出。比如 @echo "编译完成"，不会显示 echo "编译完成" 这一行。
命令前加 - 可以忽略错误。比如 -rm *.o，即使没有 .o 文件也不会报错退出。

clean:
    @echo "正在清理..."
    -rm -f *.o
    @echo "清理完成"

嗯，这里要注意：- 和 @ 可以组合使用，写成 @-rm -f *.o，既隐藏命令又忽略错误。

2.6 一个完整的例子

把上面所有知识点串起来，一个典型的 Makefile 长这样：

# 目标：编译整个项目
all: hello

# 生成可执行文件
hello: main.o utils.o
    gcc -o hello main.o utils.o

# 编译 main.o
main.o: main.c defs.h
    gcc -c main.c

# 编译 utils.o
utils.o: utils.c defs.h
    gcc -c utils.c

# 清理
.PHONY: clean
clean:
    @echo "清理中..."
    -rm -f *.o hello
    @echo "清理完成"

这个例子虽然简单，但包含了 Makefile 最核心的要素：目标、依赖、命令、伪目标。你把这个吃透了，后面讲变量、函数、自动推导，都是在这个基础上加料。

我个人习惯把 all 放在第一个目标，这样用户直接输入 make 就能编译全部。而 clean 这种辅助目标，放在文件末尾，用 .PHONY 明确声明。

好了，这一章的核心内容就这些。记住：目标、依赖、命令，三个要素缺一不可。伪目标是你避免踩坑的好帮手，别偷懒不写。