使用Makefile编译GCC出现未定义main与重复定义错误求助

从你遇到的错误（重复定义、main未定义）和正确的命令行对比来看，问题大概率出在Makefile的编译/链接逻辑上，以下是常见错误场景和修复方案：

常见错误原因 #

1. 重复编译链接源文件：比如Makefile中多次将engine.c或main.c加入编译/链接步骤，导致符号重复定义。
2. 错误生成可执行文件而非目标文件：若为单个源文件单独写了规则，却生成了可执行文件（而非.o目标文件），后续链接时把这个可执行文件当成目标文件加入，会导致符号重复。
3. 链接时遗漏main.c对应的目标文件：规则中只链接了engine相关文件，没包含main.o，就会出现undefined reference to main。

修正后的Makefile示例 #

参考你正确的命令行，标准的分步编译Makefile应该是这样的：

# 编译器与基础参数
CC = gcc
# 头文件搜索路径，和你命令里的-I参数一致
CFLAGS = -I/home/antoine/work/Game -I/usr/includes/SDL2
# 链接库参数
LDFLAGS = -lSDL2

# 所有需要的目标文件
OBJS = main.o engine.o

# 最终可执行文件目标
game: $(OBJS)
	$(CC) $(OBJS) $(LDFLAGS) -o $@

# 编译main.c为目标文件
main.o: src/main.c src/system/engine.h
	$(CC) $(CFLAGS) -c $< -o $@

# 编译engine.c为目标文件
engine.o: src/system/engine.c src/system/engine.h
	$(CC) $(CFLAGS) -c $< -o $@

# 清理生成文件
clean:
	rm -f $(OBJS) game

关键修复点说明 #

• 采用分步编译：先把每个.c文件编译成.o目标文件（-c参数只编译不链接），避免重复编译源文件导致符号重复。
• 链接阶段只使用.o文件：确保所有需要的目标文件（包括main.o）都被加入，解决main未定义问题。
• 参数与正确命令对齐：CFLAGS和LDFLAGS完全复用你命令行里的头文件路径和库参数，避免路径或库遗漏。

自查步骤 #

1. 检查你的Makefile链接规则，是否重复加入了.c文件，或者错误地将可执行文件当成目标文件链接。
2. 确认所有需要的目标文件（尤其是main.o）都出现在链接步骤中。
3. 对比Makefile里的路径、参数，和你正确的命令行是否完全一致，避免路径写错导致编译了错误的文件副本。

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