Makefile 语法学习

Makefile 语法学习有稍稍在Linux 下碰过程序设计的开发者应该会知道，make 是用来将程序代码、函式库、头文件及其它资源文件build 成最终成果（即：最终的应用程序）的超强力辅助工具。

当然了，并不是非得动用到make 才能build 程序，或许有什么程序设计魔人喜欢什么都自己手动进行；但利用make 及其参考档（输入档案）Makefile 将会让整个编译工作轻松许多。

若您曾经打包过Debian Package，那么应该会发现debuan/rule 这个档案的语法和Makefile 几乎是一模一样，所以学习Makefile 的语法对于Debian Package Maintainer 而言也是一门必要的功课。

Makefile语法：以下为Makefile 的基本语法，批注：以# 开头的即为批注。

变量宣告：（有人称之为宏）语法：MACRO = value注意到，在=前后必须加上空白，而变量名称为大小写相异。

利用MACRO = 来取消该变数。

在惯例上，Makefile 内部使用的变量名称使用小写；而使用者很可能从命令行自行另外指定数值的变量，像是CFLAGS，则是使用大写。

在Makefile 中，可利用$(MACRO) 或${MACRO} 来存取已定义的变量。

例：tragets = foo$(targets): common.hgcc -o $(targets) foo.c效果等同：foo: common.hgcc -o foo foo.c:=语法注意到，make 会将整个Makefile 展开后，再决定变数的值。

也就是说，变量的值将会是整个Mackfile 中最后被指定的值。

例：x = fooy = $(x) barx = xyz# y 的值为xyz bar在上例中，y 的值将会是xyz bar，而不是foo bar。

您可以利用:= 来避开这个问题。

:= 表示变量的值决定于它在Makefile 中的位置，而不是整个Makefile 展开后最终的值。

x := fooy := $(x) barx := xyz# y 的值为foo bar在上例中，y 的值将会是foo bar，而不是xyz bar 了。

?=语法：?= 是一个简化的语法：若变量未定义，则替它指定新的值。

否则，采用原有的值。

例：FOO ?= bar若FOO 未定义，则FOO = bar；若FOO 已定义，则FOO 的值维持不变。

+=语法：例：CFLAGS = -Wall -gCFLAGS += -O2此时CFLAGS 的值就变成-Wall -g -O2 了。

define语法：使用define 语法的唯一优点是它可以让变量直接使用『断行』。

例：define foouname -aecho $$SHELLendefall:$(foo)上例可以视同于：foo = uname -a; echo $$SHELLall:$(foo)注意到在上例中使用了$$，让'$' 能传到Shell 中。

在target里另外指定变量的值可以在target 里另外指定变量的值。

例：foo = abcall: foo = xyzall:echo $(foo)# 此时，foo 的值为xyz以下的语法提供了和上例相同的功能：all: override foo = xyzall: export foo = xyzmake 也可以存取环境变量。

例：all:@echo $(CFLAGS)在上例中，虽然在Makefile 里虽然没有指定CFLAGS 的值，但make 会试图以环境变量来代出CFLAGS 的值。

可搭配wildcard 指令在变量里展开* ? [...] 等通配符。

例：objects=$(wildcard *.o)规则：（Rule）指示make 如何进行编译。

主要语法：target: dependencies<Tab>Commands或target: dependencies; Commands<Tab>CommandsRule 指示了make 如何建立target；及何时要重新建立target。

target：所要建立的档案dependencies：相依项目。

make 会据此决定是否要重新编译target。

Commands：建立target 的指令。

在Makefile 里并没有限定Rule 的先后顺序。

但默认上，make 会参考all 这个目标项目，并依据它的dependencies 来决定要建立哪些项目。

若没有all 项目，则会采用Makefile 里的第一个项目。

target：（目标项目）这个项目所要建立的档案，必须以:结尾。

例：foo.o: common.hgcc -c foo.c其中，foo.o 是这个项目要建立的档案；common.h 是相依性的项目/档案；而gcc -c foo.c 则为要产生这个项目所要执行的指令。

make 在编译时，若发现target 比较新，也就是dependencies 都比target 旧，那么将不会重新建立target，如此可以避免不必要的编译动作。

若该项目并非档案，则为fake 项目。

如此一来将不会建立target 档案。

但为了避免make 有时会无去判断target 是否为档案或fake 项目，建议利用 .PHONY 来指定该项目为fake 项目。

例：.PHONY: cleanclean:rm *.o在上例中，若不使用 .PHONY 来指定clean 为fake 项目的话，若目录中同时存在了一个名为clean 的档案，则clean 这个项目将被视为要建立clean这个档案，但clean 这个项目却又没有任何的dependencies，也因此，clean 项目将永远被视为up-to-date，永远不会被执行。

因为利用了 .PHONY 来指定clean 为fake 项目，所以make 不会去检查目录中是否存在了一个名为clean 的档案。

如此也可以提升make 的执行效率。

其它类以 .PHONY 的语法请参考：GNU `make': 4.9 Special Built-in Target Names另外，如果某个非fake 项目里的dependencies 包含了fake 项目的话，因为make 一定会执行fake 项目，这样一来，这个非fake 项目一定也会被执行。

这可能不是理想的做法。

dependencies：（相依性项目，以空白间隔）dependencies 是指定在建立target 之前，必须先检查的项目。

可以不指定。

例：foo.o: common.hgcc -c foo.c上例中是指：检查common.h。

如果它的建立日期比foo.o 新，就执行gcc -c foo.c 来重新产生foo.o。

也就是说，可以依需求建立dependencies，即使它和target 一点关系也没有。

相依性项目可以是Makefile 中其它的target。

也因此，在建立该target 之前，它会先检查在dependencies 里所指定的所有target。

Commands：（即为要执行的Shell 指令）必须以<Tab>开头。

使用Shell Script 语法。

在Makefile 里，只要以<Tab> 开头都将会被视为Shell Script 执行。

每条法则必须写在同一行。

每条Command 会启动一个新的Shell，预设为/bin/sh。

若执行完某条Command 但传回了错误值，make 就会中断执行。

因为每条Command 会启动一个新的Shell，所以有时执行的指令必须写在同一行，像是使用if 来进行条件判断，此时可以用; 来分隔指令。

例：all:if [ -f foo ];then rm foo;fi而以下是错误示范：all:cd subdir; $(MAKE)这时因为make 只会检查最后一个指令的传回值，所以在以上指令中，即使subdir 不存在，但make 并不会因而中断执行，并会继续执行$(MAKE) 指令，而产生了不可预期的结果。

为了避免这个问题，可以利用&& 来检查其中某个指令是否成功执行，再决定是否执行下个指令。

例：all:cd subdir && $(MAKE)特别字符：@：不要显示执行的指令。

-：表示即使该行指令出错，也不会中断执行。

例：.PHONY: cleanclean:@echo "Clean..."-rm *.o因为make 会一行一行将正在执行的Commands 显示在屏幕上，但您可以利用@ 来暂时关闭这个功能。

而make 只要遇到任何错误就会中断执行。

但像是在进行clean 时，也许根本没有任何档案可以clean，因而rm 会传回错误值，因而导致make 中断执行。

我们可以利用- 来关闭错误中断功能，让make 不会因而中断。

隐性法则：在上例中的：foo.o: common.hgcc -c foo.c由于产生foo.o 的指令就是gcc -c foo.c，因此在Makefile 里可以将其简化为：foo.o: common.h此时make 会依据target 的扩展名来猜测该如何编译target。

如此可以让Makefile 更为简洁。

您可以利用【空白指令】来避免make 依据隐性法则而进行编译。

例：foo.o: common.h<Tab>内部变数：$?：代表已被更新的dependencies 的值。

也就是dependencies 中，比tragets 还新的值。

$@：代表tragets 的值。

$<：代表第一个dependencies 的值。

$* : 代表tragets 所指定的档案，但不包含扩展名。

例：print: foo1.c foo2.c foo3.clpr -p $?touch print这样会将foo1.c foo2.c foo3.c 中已有更新的内容印至打印机。

内部函数：您可以在Makefile 使用make 所支持的一些内部函数。

详情请参考：GNU `make': 8 Functions for Transforming Text条件判断：可以在Makefile 中使用以下的条件判断语法。

但由于它们不是rule，所以不可以<Tab> 开头；但其后要执行的指令则必须以<Tab> 开头，make 才会视其为Shell 指令。

ifeq：（检查value1, value2 是否相等）ifeq (value1, value2)...else...endififneq：（提供和ifeq 相反的功能）ifneq (value1, value2)...else...endififdef：（检查variable 变量是否为空的）ifdef variable...else...endififndef：（提供和ifdef 相反的功能）ifdef variable...else....endif引入档案：将外部档案引入Makefile 中。