如何重构Makefile中的重复代码与规则？

核心思路 #

针对多编译目标（release/debug/tsan）规则重复的问题，核心是抽离通用逻辑、用目标特定变量区分差异，同时通过目录隔离不同模式的中间文件，避免编译产物冲突，且满足$(NAME)生成在当前目录的约束。

基础优化方案（适配小型项目） #

通过目标特定变量+通用规则减少重复代码，同时保持简洁易维护：

# 基础配置
NAME := myapp
SRCS := $(wildcard *.c)
BASE_CFLAGS := -MMD -MP -Wall -Wextra  # 通用编译选项，包含依赖生成
LDFLAGS :=
OBJ_DIR := obj  # 统一存放中间文件的目录

# 按编译模式区分目标文件路径
RELEASE_OBJS := $(SRCS:%.c=$(OBJ_DIR)/release/%.o)
DEBUG_OBJS := $(SRCS:%.c=$(OBJ_DIR)/debug/%.o)
TSAN_OBJS := $(SRCS:%.c=$(OBJ_DIR)/tsan/%.o)

# 自动包含生成的依赖文件
-include $(RELEASE_OBJS:.o=.d) $(DEBUG_OBJS:.o=.d) $(TSAN_OBJS:.o=.d)

# 目标特定编译/链接选项
release: CFLAGS := $(BASE_CFLAGS) -O2 -DNDEBUG
debug: CFLAGS := $(BASE_CFLAGS) -g -O0 -DDEBUG
tsan: CFLAGS := $(BASE_CFLAGS) -g -O1 -fsanitize=thread -DNDEBUG
tsan: LDFLAGS := -fsanitize=thread

# 通用编译规则（所有模式共用）
$(OBJ_DIR)/%/%.o: %.c
	@mkdir -p $(@D)  # 自动创建目标目录
	$(CC) $(CFLAGS) -c $< -o $@

# 链接规则
$(NAME): $(RELEASE_OBJS)
	$(CC) $(LDFLAGS) $^ -o $@

$(OBJ_DIR)/debug/$(NAME): $(DEBUG_OBJS)
	$(CC) $(LDFLAGS) $^ -o $@

$(OBJ_DIR)/tsan/$(NAME): $(TSAN_OBJS)
	$(CC) $(LDFLAGS) $^ -o $@

# 快捷运行目标
run-release: release
	./$(NAME)

run-debug: debug
	./$(OBJ_DIR)/debug/$(NAME)

run-tsan: tsan
	./$(OBJ_DIR)/tsan/$(NAME)

# 清理目标
clean:
	rm -rf $(OBJ_DIR) $(NAME)

优化点说明 #

1. 抽离通用配置：把所有目标共用的编译选项、源文件列表、依赖生成逻辑统一定义，避免重复编写。
2. 目录隔离中间文件：不同模式的.o和.d文件存放在对应子目录，不会互相覆盖，也方便批量清理。
3. 目标特定变量：仅在每个目标下定义差异的CFLAGS/LDFLAGS，通用规则自动继承这些变量。
4. 单一通用编译规则：用模式匹配覆盖所有模式的编译需求，无需为每个目标单独编写编译规则。

可扩展优化方案（支撑后续新增编译模式） #

如果以后需要新增更多编译模式（如asan、ubsan），可以用Makefile模板+eval函数批量生成规则，彻底消除重复：

# 基础配置
NAME := myapp
SRCS := $(wildcard *.c)
BASE_CFLAGS := -MMD -MP -Wall -Wextra
LDFLAGS :=
OBJ_DIR := obj

# 自动包含依赖文件
-include $(wildcard $(OBJ_DIR)/*/*.d)

# 定义编译目标模板：参数1=目标名，参数2=专属CFLAGS，参数3=专属LDFLAGS
define BUILD_TEMPLATE
$(1): CFLAGS := $(BASE_CFLAGS) $(2)
$(1): $(if $(filter release,$(1)),$(NAME),$(OBJ_DIR)/$(1)/$(NAME))

$(OBJ_DIR)/$(1)/%.o: %.c
	@mkdir -p $(@D)
	$(CC) $(CFLAGS) -c $$< -o $$@

$(if $(filter release,$(1)),$(NAME),$(OBJ_DIR)/$(1)/$(NAME)): $(SRCS:%.c=$(OBJ_DIR)/$(1)/%.o)
	$(CC) $(LDFLAGS) $(3) $$^ -o $$@
endef

# 批量生成各目标规则
$(eval $(call BUILD_TEMPLATE,release,-O2 -DNDEBUG,))
$(eval $(call BUILD_TEMPLATE,debug,-g -O0 -DDEBUG,))
$(eval $(call BUILD_TEMPLATE,tsan,-g -O1 -fsanitize=thread -DNDEBUG,-fsanitize=thread))
# 新增模式只需添加一行，比如AddressSanitizer：
# $(eval $(call BUILD_TEMPLATE,asan,-g -O1 -fsanitize=address -DNDEBUG,-fsanitize=address))

# 快捷运行目标
run-release: release
	./$(NAME)
run-debug: debug
	./$(OBJ_DIR)/debug/$(NAME)
run-tsan: tsan
	./$(OBJ_DIR)/tsan/$(NAME)

clean:
	rm -rf $(OBJ_DIR) $(NAME)

扩展优势 #

• 新增编译模式时，仅需调用BUILD_TEMPLATE模板传入参数，无需重复编写编译和链接规则。
• 所有规则逻辑集中在模板里，便于统一修改（比如调整编译命令、添加新的通用选项）。

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