带子文件夹的Makefile编译及clean报错问题排查与修复求助

我有一个包含大量子文件夹的C项目，尝试编写Makefile将所有代码编译为单个.exe文件，当前使用的Makefile如下：

#Makefile

CFLAGS = -Wall -Wextra -O3

SRC = $(wildcard */*.c)

OBJ = $(SRC:.c=.o)

all : Executable

Executable : $(OBJ)
    gcc -o Executable  $(OBJ)

#将所有.c文件转换为.o文件
%.o : %.c
    gcc -o $(OBJ) -c $(SRC)

clean:
    rm Executable
    find . -type f -name "*.o" -exec rm {} \;

#END

但该Makefile无法正常运行，出现两类错误：

1. clean目标执行错误 #

find . -type f -name "*.o" -exec rm {} \;
cc  -o clean  
cc: fatal error: no input files
compilation terminated.
make: *** [Makefile:21: clean] Error 1

2. 编译阶段错误 #

gcc -o construct_grid/construct_grid.o detect_boxes/detect_boxes.o detect_character/detect_character.o errors/errors.o fileManager/fileManager.o preprocessing/preprocessing.o solver/solver.o -c construct_grid/construct_grid.c detect_boxes/detect_boxes.c detect_character/detect_character.c errors/errors.c fileManager/fileManager.c preprocessing/preprocessing.c solver/solver.c
gcc: fatal error: cannot specify ‘-o’ with ‘-c’, ‘-S’ or ‘-E’ with multiple files
compilation terminated.
make: *** [Makefile:17: construct_grid/construct_grid.o] Error 1

问题分析 #

1. clean目标的问题 #

• 未将clean声明为伪目标（.PHONY），make会默认把它当作一个文件目标处理，尝试调用默认编译规则生成名为clean的文件，因此出现cc -o clean的错误。
• rm Executable命令在文件不存在时会抛出错误，缺少-f参数忽略不存在的文件。

2. 编译规则的问题 #

%.o: %.c规则错误地使用了全局变量$(OBJ)和$(SRC)，导致gcc一次性处理所有源文件并试图生成所有目标文件。而-c参数要求单个源文件对应单个目标文件，同时指定多源文件和多目标文件必然触发参数冲突错误。

修复后的Makefile #

# Makefile
CFLAGS = -Wall -Wextra -O3

# 递归查找所有子目录下的.c文件
SRC = $(wildcard */*.c)
OBJ = $(SRC:.c=.o)

# 默认目标
all: Executable

# 链接生成可执行文件
Executable: $(OBJ)
	gcc $(CFLAGS) -o $@ $^

# 单个.c文件编译为对应的.o文件
%.o: %.c
	gcc $(CFLAGS) -c -o $@ $<

# 声明clean为伪目标，避免与同名文件冲突
.PHONY: clean
clean:
	rm -f Executable
	find . -type f -name "*.o" -exec rm -f {} \;

# END

关键修改说明 #

• 给clean添加.PHONY声明，明确告知make这是一个操作目标而非文件，避免触发默认编译规则。
• rm命令增加-f参数，忽略不存在的文件，避免清理时报错。
• 编译规则使用make自动变量：$@代表当前目标文件（对应单个.o），$<代表当前依赖文件（对应单个.c），确保每个源文件单独编译，符合-c参数的使用规范。
• 链接阶段加入$(CFLAGS)，保持编译与链接参数一致，提升项目编译的规范性。

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