自定义带src/obj目录的Makefile为何出现重复链接？

你的Makefile出现重复链接问题的核心原因是目标与编译逻辑不匹配，当存在多个源文件时，每个目标文件（.o）都会被编译为所有源文件的集合，最终链接时重复引入相同的符号定义。

原Makefile的关键问题 #

1. 硬编码的编译命令：$(OBJ)规则中，编译命令直接使用$(SRC_DIR)$(SRC)，即所有源文件，而不是单个源文件对应单个目标文件。比如如果SRC = main.cpp foo.cpp，OBJ = main.o foo.o，那么编译main.o和foo.o时都会同时编译main.cpp和foo.cpp，导致两个.o文件包含完全相同的符号。
2. 目标规则的错误匹配：$(OBJ): $(OBJ_DIR)这种写法会让所有.o目标共享同一个编译命令，无法实现“单个源文件生成单个目标文件”的对应关系。

修正后的Makefile #

NAME =      program
SRC_DIR =   src/
OBJ_DIR =   obj/
# 自动扫描src目录下所有.cpp文件
SRC =       $(wildcard $(SRC_DIR)*.cpp)
# 将src/*.cpp转换为obj/*.o
OBJ =       $(patsubst $(SRC_DIR)%.cpp, $(OBJ_DIR)%.o, $(SRC))
CC =        c++
CFLAGS =    -Wall -Werror -Wextra -std=c++98 -fsanitize=address

all:        $(NAME)

# 模式规则：单个.cpp对应生成单个.o
$(OBJ_DIR)%.o: $(SRC_DIR)%.cpp | $(OBJ_DIR)
            $(CC) $(CFLAGS) -c $< -o $@

# 创建obj目录（order-only依赖，避免目录更新触发全量编译）
$(OBJ_DIR):
            mkdir -p $(OBJ_DIR)

# 链接所有.o文件生成最终程序
$(NAME):    $(OBJ)
            $(CC) $(CFLAGS) $^ -o $@

clean:
            rm -rf $(OBJ_DIR)

fclean:     clean
            rm -f $(NAME)

re:         fclean all

.PHONY:     all clean fclean re

关键修正点说明 #

• 自动变量与模式规则：使用$(OBJ_DIR)%.o: $(SRC_DIR)%.cpp模式规则，让每个obj/*.o目标对应src/*.cpp源文件；编译命令中$<代表当前依赖的源文件，$@代表当前目标文件，确保单个源文件编译为单个目标文件。
• Order-only依赖：| $(OBJ_DIR)表示仅当obj目录不存在时才执行创建命令，避免目录修改时间更新时触发所有文件重新编译。
• 自动扫描源文件：$(wildcard)自动获取src下所有.cpp文件，无需手动维护源文件列表，扩展性更强。
• 可靠的链接命令：$^代表所有依赖的.o文件，替代硬编码路径，避免手动拼接错误。

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