📚 课程目录第2章 Makefile基础语法

2. Makefile 基础语法：规则格式详解、目标与依赖的写法、命令行的 Tab 键要求、注释与换行

好，咱们正式开始写 Makefile。这一章是地基，地基不稳，后面全白搭。我见过不少项目，Makefile 写得花里胡哨，结果一执行就报错，十有八九是基础语法没吃透。

Makefile 的核心就一句话：目标（target）依赖于一些文件（prerequisites），然后通过命令（recipe）来生成或更新目标。听起来简单，但细节里全是坑。咱们一个一个拆开讲。

一条 Makefile 规则长这样：

目标: 依赖文件1 依赖文件2 ...
<Tab>命令1
<Tab>命令2

举个例子：

main.o: main.c
    gcc -c main.c -o main.o

这里 main.o 是目标，main.c 是依赖，gcc -c main.c -o main.o 是命令。意思就是：如果 main.c 比 main.o 新，或者 main.o 不存在，就执行这条命令。

核心逻辑：Make 通过比较目标和依赖的时间戳来决定是否需要重新构建。依赖更新了，目标就得重建。这是 Make 的增量编译基础。

目标不一定非得是 .o 文件。它可以是一个伪目标，比如 clean、all。伪目标不生成文件，只是执行一组命令。

clean:
    rm -f *.o main

但有个坑：如果当前目录下恰好有一个叫 clean 的文件，Make 会认为这个目标已经是最新的，不会执行命令。我当年第一次遇到这个问题，排查了半天，最后发现是手贱创建了一个 clean 文件。

解决办法是用 .PHONY 声明伪目标：

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

依赖可以写多个，用空格隔开。也可以写路径：

obj/main.o: src/main.c include/header.h
    gcc -c src/main.c -o obj/main.o

依赖的顺序不重要，Make 会自动分析依赖关系。但建议按逻辑顺序写，方便人看。

这是新手最容易翻车的地方。Makefile 规定：命令必须以 Tab 键开头，不能用空格代替。

为什么？因为 Make 的语法解析器就是这么设计的。Tab 是命令行的标识符，空格会被当成普通字符。

我曾经帮一个同事调试 Makefile，他死活说自己的命令没写错，但 Make 一直报 *** missing separator. Stop.。我过去一看，好家伙，他用的是 8 个空格，不是 Tab。这个错误信息就是 Make 在告诉你：你该用 Tab 的地方没用好。

怎么避免？

如果你实在想用空格，也不是不行。GNU Make 4.0 之后支持 .RECIPEPREFIX 变量，可以自定义命令前缀。但我个人不建议这么干——团队里其他人不一定知道这个特性，容易造成混乱。

注释用 # 开头，从 # 到行尾都会被忽略。

# 这是注释
main.o: main.c  # 这也是注释
    gcc -c main.c -o main.o

注意：注释不能写在命令行的中间，因为命令行的 # 会被当成普通字符传给 shell。比如：

main.o: main.c
    gcc -c main.c -o main.o  # 这个注释会被传给 gcc，导致报错

换行用反斜杠 \。这个在依赖列表或命令很长时特别有用。

main.o: main.c \
        helper.c \
        header.h
    gcc -c main.c -o main.o

反斜杠后面不能有空格或注释，否则换行会失效。我踩过这个坑：

# 错误的写法
main.o: main.c \  # 这里有个空格，换行失效
        helper.c

Make 会把 \ 和后面的空格当成一个整体，结果就是依赖列表被截断，编译时找不到 helper.c。

咱们把这一章的核心知识点整理成一张图，方便你对照记忆。

我的习惯：每次写完 Makefile，先用 make -n 试运行一下。这个选项只打印命令，不实际执行，能快速发现语法错误。另外，make -p 可以打印所有规则和变量，调试时特别好用。

这一章的内容不多，但都是硬功夫。记住三条铁律：