Windows下C++项目Makefile编译目标文件匹配问题求助

问题背景 #

在Windows环境下搭建通用C++项目Makefile时，通过以下方式获取所有源文件：

sources := $(wildcard src/*.cpp) $(wildcard src/*/*.cpp) $(wildcard include/*.cpp) $(wildcard include/*/*.cpp)

得到源文件列表后，使用以下规则编译目标文件时，所有.o文件均仅编译src/main.cpp：

$(OBJDIR)%.o: $(sources)
    @$(CC) -c $< -o $@ $(FLAGS)

尝试提取源文件目录修改规则后，又出现make: *** No rule to make target 'obj/main.o', needed by 'debug'. Stop.的错误。

错误原因 #

• 依赖匹配错误：原规则中$(sources)作为所有.o文件的依赖，$<会取依赖列表的第一个文件（即src/main.cpp），导致所有目标文件都用同一个源编译。
• 模式规则不匹配：目标$(OBJDIR)%.o的%仅匹配文件名，但依赖没有对应到源文件的路径，make无法找到正确的源文件来生成目标。

解决方案 #

关键修改点 #

1. 建立源文件与目标文件的一一映射：通过foreach和eval动态生成每个.o文件对应的源文件依赖。
2. 自动创建目标目录：添加$(OBJDIR)的生成规则，确保编译前目录存在。
3. 优化编译规则：使用通用规则处理所有.o文件的编译，自动匹配对应源文件。

修改后的完整Makefile #

# 项目设置
project_name := Nimble
version := 0.0.1

# 编译器设置
# 优化包含路径：自动获取src、include及其子目录
INCLUDE_PATHS := $(addprefix -I ,$(wildcard src include src/* include/*))
LIBS := -lraylib -lopengl32 -lgdi32 -lwinmm -llua54
CC := g++
CPP_STD := c++20
DEBUGFLAGS_O := -std=$(CPP_STD) -Wno-missing-braces -g -Wall -m64 $(INCLUDE_PATHS)
RELEASEFLAGS_O := -std=$(CPP_STD) -Wno-missing-braces -O3 -Wall -m64 $(INCLUDE_PATHS)

# 路径设置
OUTPATH_DEBUG := bin/debug/$(project_name)
OUTPATH_RELEASE := bin/release/$(project_name)
OBJDIR := obj/
SRCDIR := src/

# 获取所有头文件与源文件
headers := $(wildcard src/*.h src/*/*.h include/*.h include/*/*.h)
sources := $(wildcard src/*.cpp src/*/*.cpp include/*.cpp include/*/*.cpp)

# 生成目标文件列表：所有源文件对应到obj目录下的同名.o
object_files := $(addprefix $(OBJDIR),$(notdir $(sources:.cpp=.o)))

# 动态生成每个.o文件对应的源文件依赖
$(foreach src,$(sources),$(eval $(OBJDIR)$(notdir $(src:.cpp=.o)): $(src)))

# 打印调试信息
print:
	@echo Object Files:
	@echo $(object_files)
	@echo Sources:
	@echo $(sources)
	@echo Include Paths:
	@echo $(INCLUDE_PATHS)

# 编译模式设置
debug: FLAGS := $(DEBUGFLAGS_O)
release: FLAGS := $(RELEASEFLAGS_O)

# 发布版构建
release: $(OBJDIR) $(object_files)
	@$(CC) $(object_files) -o $(OUTPATH_RELEASE) -s -L lib/ $(LIBS)
	@xcopy graphics\\ bin\\release\\graphics\\ /s /Y

# 调试版构建
debug: $(OBJDIR) $(object_files)
	@$(CC) $(object_files) -o $(OUTPATH_DEBUG) -L lib/ $(LIBS)
	@xcopy graphics\\ bin\\debug\\graphics\\ /s /Y

# 通用目标文件编译规则
$(OBJDIR)%.o:
	@echo Compiling $< to $@
	@$(CC) -c $< -o $@ $(FLAGS)

# 创建obj目录
$(OBJDIR):
	@if not exist $(OBJDIR) mkdir $(OBJDIR)

# 清理目标
clean:
	@echo Cleaning object files...
	@if exist $(OBJDIR) rmdir /s /q $(OBJDIR)
	@echo Cleaning done

额外优化建议 #

• 保留目标文件的目录结构：如果项目中有同名源文件（如不同子目录下的utils.cpp），可以将目标文件按源文件目录结构存放，避免冲突：

  # 替换object_files的生成方式
  object_files := $(patsubst %.cpp,$(OBJDIR)%.o,$(sources))
  # 动态创建子目录
  $(foreach dir,$(sort $(dir $(object_files))),$(eval $(dir):; @if not exist $@ mkdir $@))
  # 修改构建规则，依赖子目录
  debug: $(sort $(dir $(object_files))) $(object_files)
  release: $(sort $(dir $(object_files))) $(object_files)
  

• 添加头文件依赖：让目标文件依赖对应的头文件，修改规则为：

  $(OBJDIR)%.o:
    @echo Compiling $< to $@
    @$(CC) -c $< -o $@ $(FLAGS) -MMD -MF $(@:.o=.d)
  -include $(object_files:.o=.d)
  

  这样修改头文件后，对应的源文件会自动重新编译。

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