如何在Makefile中动态添加依赖项？

需求背景 #

正在学习用Makefile构建复杂项目，已实现基础编译链接功能，但需要实现：无需逐个手动指定，自动将cpp文件对应的同名头文件设为目标文件的依赖——当任意头文件修改时，对应的cpp文件能自动重新编译并参与链接。

试过用shell脚本和$(if)表达式，但因变量展开时机问题未生效；同时希望避免使用CMake等自动生成Makefile的工具，且方案能通用到任意编译器和文件类型。

目录结构 #

当前工作目录：

.
├── Makefile
└── src
    ├── main.cpp
    └── somemodule
        ├── module.cpp
        └── module.h

期望生成的目录结构：

.
├── app
├── Makefile
├── obj
│   ├── main.o
│   └── somemodule
│       └── module.o
└── src
    ├── main.cpp
    └── somemodule
        ├── module.cpp
        └── module.h

当前Makefile（存在问题） #

APP := app
SRCDIR := src
OBJDIR := obj
OBJS := obj/main.o obj/somemodule/module.o
SRCS := $(OBJS:.o=.cpp)

$(APP): $(OBJDIR) $(OBJS)
    g++ $(OBJS) -o $(APP)

$(OBJDIR):
    mkdir -p $(patsubst $(SRCDIR)%,$(OBJDIR)%,$(shell tree src -fid --noreport))

$(OBJS): HEADERS += $(if $(shell if [ -e $(@:obj%.o=src%.h) ]; then echo "y"; fi), $(@:obj%.o=src%.h))
$(OBJS): $(OBJDIR)%.o: $(SRCDIR)%.cpp $(HEADERS)
    g++ -c $(patsubst $(OBJDIR)%.o,$(SRCDIR)%.cpp,$@) -o $@

.PHONY: clean
clean:
    rm -rf $(OBJDIR)
    rm $(APP)

问题分析 #

你之前的写法核心问题是：$(OBJS): HEADERS += ...是全局变量赋值，而非针对每个目标文件单独处理；且自动变量$@在Makefile的变量解析阶段还未展开，导致依赖判断逻辑完全失效。

解决方案 #

1. 核心：用wildcard实现条件依赖

GNU Make的wildcard函数可以检查文件是否存在，不存在则返回空字符串。直接在静态模式规则的依赖中使用它，就能自动为存在对应头文件的目标添加依赖：

$(OBJDIR)/%.o: $(SRCDIR)/%.cpp $(wildcard $(SRCDIR)/%.h)
    g++ -c $< -o $@

• $(wildcard $(SRCDIR)/%.h)：如果src/xxx.h存在，就将其加入依赖；不存在则忽略，完全符合“条件添加”的需求。
• $<：自动变量，代表当前规则的第一个依赖（也就是对应的cpp文件），比手动用patsubst替换更简洁可靠。

2. 优化OBJ目录创建（移除tree依赖）

tree不是所有系统都默认安装，改用$(dir $(OBJS))生成所有需要的OBJ子目录，更通用：

$(OBJDIR):
    mkdir -p $(dir $(OBJS))

3. 可选：自动生成OBJS列表（适合复杂项目）

如果项目文件很多，手动写OBJS太麻烦，可以用find自动扫描所有cpp文件并转换为目标文件路径：

SRCS := $(shell find $(SRCDIR) -name "*.cpp")
OBJS := $(patsubst $(SRCDIR)/%.cpp, $(OBJDIR)/%.o, $(SRCS))

完整修改后的Makefile #

APP := app
SRCDIR := src
OBJDIR := obj

# 自动扫描所有cpp文件并生成对应目标文件路径（可选，替换手动OBJS）
SRCS := $(shell find $(SRCDIR) -name "*.cpp")
OBJS := $(patsubst $(SRCDIR)/%.cpp, $(OBJDIR)/%.o, $(SRCS))

$(APP): $(OBJS)
    g++ $(OBJS) -o $(APP)

# 确保OBJ目录及子目录存在（顺序依赖，不会因目录更新触发重编译）
$(OBJS): | $(OBJDIR)

$(OBJDIR):
    mkdir -p $(dir $(OBJS))

# 核心规则：自动关联存在的同名头文件作为依赖
$(OBJDIR)/%.o: $(SRCDIR)/%.cpp $(wildcard $(SRCDIR)/%.h)
    g++ -c $< -o $@

.PHONY: clean
clean:
    rm -rf $(OBJDIR)
    rm -f $(APP)

关键说明 #

• $(OBJS): | $(OBJDIR)：用顺序依赖（竖线|）确保OBJ目录在编译目标文件之前创建，但不会因为目录更新而触发重新编译。
• 整个方案完全通用，只要替换SRCDIR、OBJDIR、编译器命令（比如把g++换成gcc或clang），就能适配其他语言或工具链。

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