2. Makefile语法速览：规则定义、变量赋值、注释、换行与续行

说实话，很多工程师一上来就写Makefile，结果编译报错时一脸懵。我见过太多人把变量赋值搞混，或者因为一个空格问题排查半天。这一节，咱们就把Makefile最基础的语法掰开揉碎讲清楚。

2.1 规则定义——Makefile的骨架

Makefile的核心就是规则。说白了，就是告诉make：你要生成什么，依赖什么，怎么生成。

目标: 依赖
    命令

注意，命令前面必须是一个Tab键，不是空格。我当年刚入行时，就因为用空格代替Tab，折腾了半小时。嗯，这个坑几乎每个新手都会踩一次。

举个例子，一个简单的编译规则：

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

这里main.o是目标，main.c是依赖，下面一行是生成命令。make会检查：如果main.c比main.o新，就执行命令重新编译。

我个人习惯把规则写得清晰一点，尤其是大型项目，依赖关系一多，乱写真的会把自己绕进去。

2.2 变量赋值——四种方式，各有千秋

变量是Makefile的血液。但赋值方式有四种，很多人搞不清区别。我一个个说。

2.2.1 简单赋值 =

这是最基本的赋值。但有个特点：递归展开。什么意思？就是变量在引用时才会展开，而不是定义时。

A = $(B)
B = hello

all:
    @echo $(A)  # 输出 hello

你看，A定义时B还没值，但最终输出时B已经定义了，所以能拿到hello。这种灵活性有时很有用，但也会带来意想不到的问题。我在项目中遇到过因为递归展开导致变量无限循环的情况，那叫一个头疼。

2.2.2 立即赋值 :=

这个我强烈推荐。它会在定义时立即展开，后面的变化不影响它。

A := $(B)
B := hello

all:
    @echo $(A)  # 输出空，因为定义时B还没值

你想想看，这种赋值方式更符合直觉，也更容易调试。我个人习惯，90%的场景都用:=，除非有特殊需求。

2.2.3 条件赋值 ?=

只有变量未定义时才赋值。如果已经定义过，就跳过。

CC ?= gcc

这常用于给用户提供默认值。用户可以在命令行覆盖：make CC=clang，如果没传，就用gcc。我曾经在写一个通用编译框架时大量使用?=，让用户能灵活定制，又不失默认行为。

2.2.4 追加赋值 +=

在已有值后面追加内容，自动加空格。

CFLAGS = -Wall
CFLAGS += -O2
# 结果：CFLAGS = -Wall -O2

这个在累积编译选项时特别好用。比如不同模块需要不同的宏定义，用+=一层层加上去，清晰又安全。

2.3 注释——用#说清楚意图

Makefile的注释用#，从#开始到行尾都是注释。

# 这是注释
CC := gcc  # 编译器设置

我建议每个关键变量和复杂规则都加上注释。你想想看，三个月后你自己回来看代码，没有注释真的会怀疑人生。我曾经接手过一个没有注释的Makefile，里面全是=和:=混用，变量名还起得莫名其妙……那感觉，就像在迷宫里找出口。

2.4 换行与续行——长命令的优雅写法

有时候命令太长，一行写不下。Makefile用反斜杠\续行。

OBJS := main.o \
        utils.o \
        network.o

all:
    gcc -o app \
        $(OBJS) \
        -lpthread -lm

注意，\后面不能有空格或任何字符，否则续行会失效。嗯，这里要注意，我曾经因为\后面多了一个空格，导致编译时死活找不到文件，排查了半天才发现是这个问题。

2.5 知识体系一览

为了让你更直观地理解这一章的内容，我画了一张图，把Makefile语法的核心逻辑串起来。

这张图把四个核心要素串在一起。你写Makefile时，脑子里要有这个结构：先搭规则骨架，再用变量填充，注释说清楚意图，长命令用续行保持整洁。

好了，这一章的内容就这些。语法是工具，多用几次就熟了。关键是理解每种赋值的语义，以及规则依赖的触发条件。下次写Makefile时，多想想：这个变量该用:=还是=？这个命令要不要续行？注释写清楚了吗？

可可精品资料库