2. Makefile基础语法

好，咱们直接进入正题。Makefile 这东西，说白了就是一个「自动化构建说明书」。你告诉它：我要生成什么、靠什么生成、怎么生成。它就会老老实实帮你干活。

我个人习惯把 Makefile 看作一个「带依赖检查的批处理脚本」。它比普通脚本聪明的地方在于——它知道哪些文件变了，哪些没变，只重新编译需要编译的部分。嗯，这一点在大型项目里特别香。

2.1 目标、依赖与命令：铁三角

一个最基本的 Makefile 规则，长这样：

目标: 依赖1 依赖2
	命令1
	命令2

举个例子：

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

这里：

• 目标（target）：就是你要生成的东西，比如 main.o、app、clean 等。
• 依赖（prerequisites）：生成目标所需要的原材料。比如 main.c。
• 命令（recipe）：如何从依赖生成目标。比如 gcc -c main.c -o main.o。

我在项目中遇到过好几次这样的坑：明明改了代码，但 make 说「无事可做」。后来发现是目标文件的时间戳比源文件还新——因为从 git 拉代码时，时间戳没更新。解决办法？要么 touch 一下源文件，要么直接 make clean 重新来。

2.2 Tab键与空格：一字之差，天壤之别

这个问题，几乎每个初学者都会栽跟头。我当年第一次写 Makefile，折腾了半小时，就因为它报了一个莫名其妙的错误：

Makefile:3: *** missing separator.  Stop.

为什么会这样？因为 Makefile 规定：命令前面必须是一个 Tab 字符，不能是空格。

你想想看，在大多数编辑器里，Tab 和空格看起来差不多。但 Make 解析器非常严格——它只认 Tab。

特性	Tab	空格
Make 是否识别	✅ 是	❌ 否
报错信息	无	missing separator
视觉表现	通常显示为 4 或 8 个空格宽度	实际就是空格

我建议你养成一个习惯：写 Makefile 时，打开「显示不可见字符」功能。这样 Tab 和空格一眼就能分辨。

2.3 注释的写法：用 # 号

Makefile 的注释很简单，用 # 开头。从 # 到行尾的内容都会被忽略。

# 这是一个注释
# 下面这个规则用于编译 main.c
main.o: main.c
	gcc -c main.c -o main.o  # 行尾也可以加注释

嗯，这里要注意：注释不能写在命令行的前面，因为命令行的第一个字符必须是 Tab。如果你在 Tab 前面加 #，那这一行就变成注释了，命令不会执行。

2.4 知识体系一览

为了让你更直观地理解这一章的内容，我画了一张图：

这张图把 Makefile 规则拆成了三块：目标、依赖、命令。再加上注释，就是这一章的全部内容了。

2.5 实战小练习

光看不练可不行。我给你留个小任务：

1. 创建一个 hello.c 文件，里面写一个简单的 printf("Hello, Makefile!\n");
2. 写一个 Makefile，目标是 hello，依赖是 hello.c，命令用 gcc hello.c -o hello
3. 在 Makefile 里加一行注释，说明这个文件的作用
4. 运行 make，看看效果
5. 故意把 Tab 换成空格，看看报错信息长什么样

做完这个练习，你对目标、依赖、命令、Tab、注释的理解，就基本到位了。

可可精品资料库