多源文件编译Makefile：头文件缺失与SDL函数未定义问题

问题详情 #

在Windows沙箱中使用mingw32-make和gcc构建依赖SDL2的项目时，遇到以下问题：

1. 初始Makefile的头文件错误 #

初始编写的Makefile如下：

# Makefile
CC = gcc
SRC = pixel.c
TARGET = pixel.exe
OBJECTS = bmp.o pixel.o
#CFLAGS_W = -Wall -Wl,-subsystem,windows
CFLAGS_W = -Wall
LFLAGS_W = -lSDL2
INCS_W = -I.\SDL2\include
LIBS_W = -L.\SDL2\lib\x64

all: $(TARGET)

$(TARGET): $(OBJECTS)
    $(CC) $(INCS_W) $(LIBS_W) $(CFLAGS_W) $(LFLAGS_W) -g -o $(TARGET) $(OBJECTS)

编译时能生成bmp.o，但编译pixel.c时报错：

pixel.c:6:10: fatal error: SDL.h: No such file or directory
但单独编译pixel.c（未加入bmp.c）时，用以下规则可以正常构建：

all:
    $(CC) $(SRC) $(INCS_W) $(LIBS_W) $(CFLAGS_W) $(LFLAGS_W) -g -o $(TARGET)

2. 添加编译规则后的链接错误 #

添加了.c.o编译规则后：

.c.o:
    $(CC) $(INCS_W) $(LIBS_W) $(CFLAGS_W) $(LFLAGS_W) -g -c $< -o $@

编译能推进，但出现大量SDL函数未定义的错误：

C:\Users\WDAGUtilityAccount\Desktop\Projects\Pixel>mingw32-make
gcc -I./SDL2/include -L./SDL2/lib/x64 -Wall -lSDL2 -g -c bmp.c -o bmp.o
gcc -I./SDL2/include -L./SDL2/lib/x64 -Wall -lSDL2 -g -c pixel.c -o pixel.o
gcc -I./SDL2/include -L./SDL2/lib/x64 -Wall -lSDL2 -g -o pixel.exe bmp.o pixel.o
pixel.o: In function `main':
C:\Users\WDAGUtilityAccount\Desktop\Projects\Pixel/pixel.c:119: undefined reference to `SDL_Init'
...

3. 当前可行但无增量构建的方案 #

用以下规则可以编译整个项目，但每次都会全量重建，无法实现增量构建：

SRC = bmp.c pixel.c
...
test:
    $(CC) $(SRC) $(INCS_W) $(LIBS_W) $(CFLAGS_W) $(LFLAGS_W) -g -o $(TARGET)

解决方案 #

问题根源在于编译与链接阶段的参数混淆，以及链接时库的顺序错误。修正后的Makefile如下：

# Makefile
CC = gcc
TARGET = pixel.exe
OBJECTS = bmp.o pixel.o
CFLAGS_W = -Wall
# 编译阶段仅需头文件路径
INCS_W = -I./SDL2/include
# 链接阶段需库路径和库文件
LIBS_W = -L./SDL2/lib/x64
LFLAGS_W = -lSDL2

all: $(TARGET)

# 编译.c生成.o：仅用编译参数，无需链接库
.c.o:
	$(CC) $(INCS_W) $(CFLAGS_W) -g -c $< -o $@

# 链接生成可执行文件：目标文件在前，库参数在后
$(TARGET): $(OBJECTS)
	$(CC) -g -o $(TARGET) $(OBJECTS) $(LIBS_W) $(LFLAGS_W)

关键修正点 #

• 编译阶段：生成.o文件时不需要LIBS_W和LFLAGS_W，这些是链接阶段的参数。仅需指定头文件路径和编译选项，确保编译器能找到SDL头文件。
• 链接阶段：将目标文件$(OBJECTS)放在库参数之前，gcc会正确从SDL库中查找未定义的函数符号，解决链接错误。
• 增量构建：make会自动检测.c文件的修改时间，仅重新编译变化的源文件，实现增量构建。

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