如何编写使用模式规则的Makefile?解决自定义规则未触发目标文件编译的问题
问题根因
规则完全失效是两个GNU Make核心机制叠加导致的:
- 首先,GNU Make默认内置了一条通用隐式规则:当需要生成一个无扩展名的可执行目标时,如果当前目录存在同名.c源文件,就直接用gcc把.c编译链接成可执行程序,等价于内置了
%: %.c规则,执行的命令就是$(CC) $(CFLAGS) <源文件.c> -o <目标>——和你实际看到的运行输出完全一致。 - 其次,GNU Make选择生成目标的规则路径时,会在所有合法的生成路径中,优先选中步骤最短、需要创建的中间文件最少的路径。它不会默认优先使用用户在Makefile中定义的规则,而是枚举所有可能的生成链路,计算每条链路的总步骤数,选最短的那条执行。运行
make server时,Make会同时枚举所有能生成server的合法路径:- 内置直链路径:仅需1步,直接编译已存在的server.c生成server,无额外依赖
- 你自定义的规则路径:需要3步,先把server.c编译为不存在的server.o、把对应源文件编译为不存在的include.o,再把两个.o链接为server
两路径对比,内置路径的生成步骤更少,因此Make直接选中了内置路径,完全跳过了你写的模式规则的依赖校验,自然不会触发后续的.o编译流程。
- 顺带提个额外的坑:你写的.o编译规则本身有语法错误。编译目标文件时,输出应该指定为要生成的.o文件(对应Make的自动变量
$@),但你现在的命令是$(CC) $(CFLAGS) -c -o $<——$<是第一个依赖也就是同名.c源文件,执行时会直接覆盖你的.c源文件,哪怕规则路径走对了也会出问题。
修复方法
按改动量从小到大排序,任选一种即可:
- 方案1:显式覆盖内置的直链规则
在你自定义的%: %.o include.o规则前面,加一行空的同模式规则,专门用来压过内置规则:
只要你定义了同模式的规则,Make就不会用内置的实现;空规则的存在相当于告诉Make“不要走内置的这条路”。# 空规则,用来禁用内置的.c直链可执行逻辑 %: %.c - 方案2:全局关闭所有内置隐式规则
在Makefile最开头加一行配置,彻底关闭所有内置规则的加载:
这个方法适合完全自定义编译逻辑、不依赖Make任何默认行为的场景。MAKEFLAGS += --no-builtin-rules - 方案3:修正.o编译的命令错误
把原来错误的.o编译命令,从
改成正确的写法,确保编译输出为对应的.o目标文件:$(CC) $(CFLAGS) -c -o $<$(CC) $(CFLAGS) -c $< -o $@
修复后的预期效果
重新执行make server时,Make就会按照你最初的预期执行三步操作:
- 编译server.c为server.o
- 编译对应源文件为include.o
- 将两个目标文件链接为最终的server可执行程序
内容的提问来源于stack exchange,提问作者milanHrabos
相关产品推荐
相关产品推荐

