如何为同目录结构多项目编写通用Makefile并修复编译问题

项目目录结构 #

myproject/
   obj/
   src/
     file1.c
     file2.c
     file3.c
   inc/
     myproject.h
   Makefile

初始问题与报错 #

初始Makefile运行时报错：make: *** No rule to make target obj/file1.o', needed by myproject'. Stop.，核心问题有两个：

1. 链接目标$(NAME)的命令中使用了$<，这个自动变量仅代表第一个依赖文件，而非所有目标文件，会导致链接逻辑错误；
2. 未确保obj/目录存在，如果目录不存在，make无法生成该目录下的.o文件。

更新后的可运行Makefile #

你更新后的Makefile已修复链接命令的问题（改用$^代表所有依赖），但仍未实现「Makefile或头文件变更时触发全量编译」的需求：

NAME        :=  myproject

CC          :=  gcc
RM          :=  rm

CFLAGS      :=  -Wall -Wextra -Werror
LDFLAGS     :=  -Wall
RMFLAGS     :=  -f

SRCDIR      :=  src
OBJDIR      :=  obj
INCDIR      :=  inc

HEADERS     :=  $(INCDIR)/myproject.h

LINK.o      :=  $(CC) $(LDFLAGS)
COMPILE.c   :=  $(CC) -I$(INCDIR) $(CFLAGS) -c
REMOVE      :=  $(RM) $(RMFLAGS)

SRCS        :=  file1.c file2.c file3.c

SOURCES     :=  $(addprefix $(SRCDIR)/, $(SRCS))
OBJECTS     :=  $(patsubst $(SRCDIR)/%.c, $(OBJDIR)/%.o, $(SOURCES))

$(OBJDIR)/%.o: $(SRCDIR)/%.c
    $(COMPILE.c) $< -o $@

all: $(NAME)

$(NAME): $(OBJECTS)
    $(LINK.o) -o $(NAME) $^

clean:
    $(REMOVE) $(OBJECTS)

fclean: clean
    $(REMOVE) $(NAME)

re: fclean all

.PHONY: all clean fclean re

关键需求实现：Makefile/.h变更触发全量编译 #

要实现「头文件或Makefile变更时重新编译所有文件」，只需让所有目标文件（.o）依赖于Makefile和全局头文件$(HEADERS)，添加以下规则即可：

# 让所有.o文件依赖于Makefile和全局头文件
$(OBJECTS): $(HEADERS) Makefile

同时，为避免obj/目录不存在导致的报错，建议添加自动创建目录的规则：

# 确保obj目录存在
$(OBJDIR):
    mkdir -p $(OBJDIR)

# 让所有.o文件依赖于obj目录（用|表示仅检查目录是否存在，不依赖目录修改时间）
$(OBJECTS): | $(OBJDIR)

进一步优化建议 #

1. 自动收集源文件：不用手动维护SRCS列表，用wildcard自动扫描src/下的所有.c文件：

   SRCS        :=  $(wildcard $(SRCDIR)/*.c)
   OBJECTS     :=  $(patsubst $(SRCDIR)/%.c, $(OBJDIR)/%.o, $(SRCS))
   

2. 自动生成头文件依赖：添加-MMD到CFLAGS，让gcc自动生成每个.c文件的头文件依赖（包括嵌套引用的头文件），无需手动维护：

   CFLAGS      :=  -Wall -Wextra -Werror -MMD
   # 引入自动生成的.d依赖文件
   -include $(OBJECTS:.o=.d)
   

3. 清理时删除依赖文件：更新clean规则，同时删除自动生成的.d文件：

   clean:
       $(REMOVE) $(OBJECTS) $(OBJECTS:.o=.d)
   

最终完整Makefile #

整合所有修复与优化后的版本：

NAME        :=  myproject

CC          :=  gcc
RM          :=  rm

CFLAGS      :=  -Wall -Wextra -Werror -MMD
LDFLAGS     :=  -Wall
RMFLAGS     :=  -f

SRCDIR      :=  src
OBJDIR      :=  obj
INCDIR      :=  inc

HEADERS     :=  $(INCDIR)/myproject.h

LINK.o      :=  $(CC) $(LDFLAGS)
COMPILE.c   :=  $(CC) -I$(INCDIR) $(CFLAGS) -c
REMOVE      :=  $(RM) $(RMFLAGS)

# 自动收集src下所有.c文件
SRCS        :=  $(wildcard $(SRCDIR)/*.c)
OBJECTS     :=  $(patsubst $(SRCDIR)/%.c, $(OBJDIR)/%.o, $(SRCS))
# 自动生成的依赖文件
DEPS        :=  $(OBJECTS:.o=.d)

# 确保obj目录存在
$(OBJDIR):
    mkdir -p $(OBJDIR)

# 编译规则：.o依赖于对应的.c、头文件、Makefile，且obj目录必须存在
$(OBJDIR)/%.o: $(SRCDIR)/%.c $(HEADERS) Makefile | $(OBJDIR)
    $(COMPILE.c) $< -o $@

all: $(NAME)

$(NAME): $(OBJECTS)
    $(LINK.o) -o $(NAME) $^

# 清理目标文件和依赖文件
clean:
    $(REMOVE) $(OBJECTS) $(DEPS)

fclean: clean
    $(REMOVE) $(NAME)

re: fclean all

# 引入自动生成的依赖文件
-include $(DEPS)

.PHONY: all clean fclean re

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