Makefile中如何将含执行代码的头文件加入依赖列表？

• 初始Makefile没把print_val.h纳入依赖链，Make检测不到头文件的修改，因此不会触发重编译
• 错误地将print_val.h直接添加到main可执行目标的依赖中，Make会把它当成需要编译的源文件处理，但头文件本身无法直接编译为目标文件，所以出现编译错误

方法1：手动维护源文件的头文件依赖 #

直接给每个依赖print_val.h的.o目标添加头文件依赖，而非绑定到最终可执行程序。示例Makefile：

CC = gcc
TARGET = app
OBJS = main.o set_val.o

# 链接生成可执行文件
$(TARGET): $(OBJS)
	$(CC) -o $@ $^

# 明确指定每个目标文件的依赖：源文件+关联头文件
main.o: main.c print_val.h
set_val.o: set_val.c print_val.h

clean:
	rm -f $(TARGET) $(OBJS)

修改后，只要print_val.h有变动，Make会自动重新编译main.o和set_val.o，再重新链接生成可执行文件，不会再出现编译头文件的错误。

方法2：让Make自动生成头文件依赖（适合多文件项目） #

如果项目文件较多，手动维护依赖太繁琐，可以借助GCC的参数自动生成依赖规则，一劳永逸。示例Makefile：

CC = gcc
TARGET = app
OBJS = main.o set_val.o

# 自动生成的依赖文件，每个.o对应一个.d文件
DEPS = $(OBJS:.o=.d)

$(TARGET): $(OBJS)
	$(CC) -o $@ $^

# 导入自动生成的依赖规则
-include $(DEPS)

# 编译源文件时同时生成依赖文件
%.o: %.c
	$(CC) -c -o $@ $< -MMD -MP

clean:
	rm -f $(TARGET) $(OBJS) $(DEPS)

• -MMD：让GCC编译.c文件时，自动生成对应的.d文件，记录该源文件依赖的所有头文件
• -MP：为每个头文件生成空规则，避免头文件被删除时Make报错
• -include $(DEPS)：导入自动生成的依赖规则，Make会自动处理头文件修改后的重编译逻辑

• 绝对不能把头文件直接加到可执行目标的依赖列表，必须绑定到对应的.o目标（即源文件编译出的中间文件）的依赖中
• 头文件中写执行代码是合法的（比如inline函数、带代码片段的宏），但要确保头文件本身已包含所需的前置依赖（比如print_val.h里要加#include <stdio.h>才能正常使用printf）

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