如何用Makefile将目标文件编译至独立文件夹并解决重复链接问题

问题背景 #

文件夹结构包含include/、libft/、mlx/、src/，需要实现：

• 将src/下的C文件编译到obj/目录
• 链接生成可执行文件FdF
• 解决编译后目标文件不被识别、重复链接的问题

原Makefile的核心错误 #

第一个版本问题 #

• 链接阶段冗余添加了编译用的头文件参数（$(HDR)、$(LIBHDR)），导致重复引入依赖，引发链接问题
• 整体逻辑正确，但命令冗余

第二个版本问题 #

• OBJ=$($(SRC_DIR)%.c=$(OBJ_DIR)%.o)是完全错误的变量替换语法，无法生成正确的目标文件列表
• $(OBJ_DIR)%.o: %.c规则的依赖是当前目录的.c文件，而源文件实际在src/下，导致无法触发编译
• 链接时使用了未定义的$(OBJS)变量，导致找不到目标文件

修正后的Makefile #

NAME=FdF

CC=gcc
CFLAGS=-Wall -Wextra -Werror

# 依赖库路径
LIBFT=libft/libft.a
MLX=mlx/libmlx_Linux.a

# 编译阶段头文件包含（仅用于生成.o文件）
INCLUDES=-Iinclude -Ilibft -Imlx
# 链接阶段库参数（仅用于生成可执行文件）
LIBS=-Llibft -lft -Lmlx -lmlx -lX11 -lXext -lm

# 源文件与目标文件处理
SRC_DIR=src/
OBJ_DIR=obj/
# 获取src目录下所有.c文件
SRCS=$(wildcard $(SRC_DIR)*.c)
# 将src/*.c映射为obj/*.o
OBJS=$(patsubst $(SRC_DIR)%.c, $(OBJ_DIR)%.o, $(SRCS))

all: $(NAME)

# 编译libft库
$(LIBFT):
	make -C libft

# 创建obj目录（-p确保目录不存在时创建，已存在也不报错）
$(OBJ_DIR):
	mkdir -p $@

# 编译单个目标文件：依赖对应src下的.c文件，且确保obj目录先存在
$(OBJ_DIR)%.o: $(SRC_DIR)%.c | $(OBJ_DIR)
	$(CC) $(CFLAGS) $(INCLUDES) -c $< -o $@

# 链接生成可执行文件：依赖所有.o文件和libft库
$(NAME): $(OBJS) $(LIBFT)
	@echo "Generating $(NAME)..."
	$(CC) $(CFLAGS) $(OBJS) $(LIBS) -o $@

clean:
	rm -rf $(OBJ_DIR)
	make -C libft clean

fclean: clean
	rm -f $(NAME)
	make -C libft fclean

re: fclean all

.PHONY: all clean fclean re

关键修正说明 #

1. 正确的文件路径映射：用wildcard和patsubst准确生成源文件和目标文件列表，避免语法错误
2. 编译规则的依赖修正：| $(OBJ_DIR)是顺序依赖，确保先创建obj/目录再编译，且不会因目录更新触发全量重编译
3. 参数分离：将编译用的头文件参数和链接用的库参数分开，避免重复引入导致的链接问题
4. 变量统一：全程使用$(OBJS)指代目标文件，避免未定义变量的错误
5. 简化命令：链接阶段只保留必要的目标文件和库参数，去掉冗余的头文件引入

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