Makefile使用通配符调用目标文件：首次构建报错的问题排查与修复

这种“clean后第一次编译报错，第二次正常”的情况我碰到过好多次，核心问题基本都是你的Makefile没给可执行文件明确声明全所有必需的依赖目标，导致链接步骤跑在了目标文件生成前面。

举个最典型的错误写法，你大概率是类似这样写的：

.PHONY: all clean

all: program

program:
	# 用*.o凑目标文件，但Makefile根本不知道要先生成这些.o
	cc -o program *.o

libfoo.o: libfoo.c libfoo.h
	cc -c libfoo.c

clean:
	rm -f program *.o

为啥会出问题？当你make clean后，所有.o和可执行文件都被清掉了。第一次跑make all时，Makefile看到program目标没有依赖，直接就执行链接命令了——但这时候*.o是空的啊！相当于你直接敲了cc -o program，编译器找不到任何包含main函数的代码，自然就报undefined reference to main了。

那第二次为啥又正常？因为第一次跑make的时候，虽然链接失败了，但libfoo.o已经被生成了；第二次跑的时候，Makefile发现program不存在，这时候它会触发隐含规则：看到你有main.c，自动帮你生成main.o，加上已经存在的libfoo.o，链接命令就能找到所有需要的文件，自然就成了。

怎么修复？ #

核心就是给可执行文件目标明确列全所有依赖的.o文件，让Makefile知道必须先把这些.o都生成好，再去做链接。

修正后的写法参考：

.PHONY: all clean

# 明确告诉Makefile：program得等main.o和libfoo.o都做好才能生成
all: program

program: main.o libfoo.o
	# 用$^可以自动引用所有依赖，后续加新.o也不用改这条命令
	cc -o $@ $^

# 给main.o加规则（如果需要自定义编译参数的话，不加也能靠隐含规则，但明确写更清晰）
main.o: main.c libfoo.h
	cc -c main.c

libfoo.o: libfoo.c libfoo.h
	cc -c libfoo.c

clean:
	rm -f program *.o

这样改完后，make clean再跑make all，Makefile会先检查main.o和libfoo.o，发现不存在就先编译生成它们，等所有依赖都齐了再执行链接，绝对不会再出现第一次报错的情况。

另外再给你两个小建议：

• 尽量别依赖Makefile的隐含规则，明确写全依赖和规则，能避免很多莫名其妙的问题；
• 用$@（代表当前目标）和$^（代表所有依赖）这些自动变量，能让Makefile更简洁好维护。

内容的提问来源于stack exchange，提问作者Anonymous Entity