GNU Make自动依赖问题：重命名头文件后构建失败如何修复？

Let's break down why this error happens and how to fix it properly.

The Root Cause #

Your current .d dependency files are hardcoding the old header path (like config.h). When you rename the header and update the source file, Make still reads the outdated .d file and tries to build against the old, non-existent header. The problem is your dependency generation rule doesn't automatically update .d files when headers are renamed or modified.

Solution 1: Use Compiler-Built Dependency Generation (Simplest & Recommended) #

Instead of writing a custom rule for .d files, leverage your compiler's built-in flags to generate and update dependencies automatically. For GCC (and most compilers), use -MMD and -MP:

SRCS := $(wildcard *.c)
OBJS := $(SRCS:%.c=%.o)
DEPS := $(OBJS:%.o=%.d)

# Compile source files, and generate .d dependency files in one step
$(OBJS): %.o: %.c
	$(CC) $(CFLAGS) -MMD -MP -c -o $@ $<

# Include dependency files; the '-' prefix ignores errors if .d files don't exist yet
-include $(DEPS)

# Optional: Clean rule to remove built files
.PHONY: clean
clean:
	rm -f $(OBJS) $(DEPS)

What These Flags Do:

• -MMD: Generates a .d file for each source, containing only user-defined headers (not system headers)
• -MP: Creates "phony" targets for each header in the .d file. This prevents Make from throwing errors if a header is deleted.

With this setup, whenever you modify a source file or rename a header, the compiler will regenerate the .d file with the correct new dependencies on the next make run.

Solution 2: Custom Dependency Generation Rule #

If you need a custom rule for .d files (for example, if you're not using GCC), update the rule to ensure .d files are regenerated when headers change:

SRCS := $(wildcard *.c)
OBJS := $(SRCS:%.c=%.o)
DEPS := $(OBJS:%.o=%.d)

$(OBJS): %.o: %.c
	$(CC) $(CFLAGS) -c -o $@ $<

-include $(DEPS)

# Generate .d files with proper dependency tracking
$(DEPS): %.d: %.c
	# Generate raw dependencies to a temp file
	$(CC) $(CFLAGS) -M $< > $@.tmp
	# Modify the temp file to make .d depend on headers too, then replace the .d file
	sed 's,\($*\)\.o[ :]*,\1.o $@ : ,g' $@.tmp > $@
	# Clean up the temp file
	rm -f $@.tmp

.PHONY: clean
clean:
	rm -f $(OBJS) $(DEPS)

The sed command modifies the raw dependency output to include the .d file itself as a target dependent on the headers. This way, if a header is renamed or modified, Make will regenerate the .d file instead of using the outdated version.

Why This Fixes Your Problem #

Both solutions ensure that when you rename config.h to config2.h and update config.c, the next make run will:

1. Detect that config.c has changed
2. Regenerate config.d with the new config2.h dependency
3. Build the object file using the correct header path

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