基于Makefile的大规模代码库GCC依赖生成优化方案问询

针对超大规模代码库中依赖更新耗时过长的问题，可以通过让GCC为每个头文件单独生成依赖链（.hd文件），并让源文件的编译依赖这些.hd文件的方式，实现头文件仅扫描一次的目标，同时完全兼容GCC的宏和C23新特性。

核心思路 #

每个头文件仅被GCC扫描一次，生成包含其所有嵌套依赖的.hd文件；源文件的编译规则依赖对应的.hd文件，当头文件修改时，仅需更新对应的.hd，再触发依赖它的源文件重新编译，无需重复扫描所有引用该头文件的源文件。

具体实现步骤 #

1. 生成头文件的依赖文件（.hd） #

编写Makefile规则，让GCC以头文件模式扫描每个.h文件，生成对应的.hd，包含该头文件的所有依赖链：

# 定义头文件搜索路径、编译参数（和编译源文件时一致）
CFLAGS += -Iinclude -Isrc ...

# 生成单个头文件的依赖文件
%.hd: %.h
	# -x c-header：强制GCC将输入视为C头文件处理
	# -MM：仅生成用户头文件依赖（忽略系统头文件）
	# -MP：生成空规则避免删除头文件时的错误
	# -MF：指定输出的依赖文件名
	gcc -MM -MP -MF $@ -x c-header $(CFLAGS) $<
	# 将当前.hd文件添加到自身依赖中，确保头文件更新时重新生成.hd
	echo "$@: $$(sed -n 's/^.*: //p' $@)" >> $@

以你的示例为例，shared.h生成的shared.hd内容如下：

shared.h: 1.h 2.h 3.h
1.h:
2.h:
3.h:
shared.hd: 1.h 2.h 3.h

2. 修改源文件的依赖生成规则 #

让源文件的.d依赖文件中，自动添加对应头文件的.hd依赖，确保源文件编译时感知头文件依赖链的变化：

# 生成源文件的依赖文件
%.d: %.c
	gcc -MM -MP -MF $@ $(CFLAGS) $<
	# 将每个.h依赖项替换为.h + .hd，让.o同时依赖头文件和其依赖链文件
	sed -i 's/\(\.h\)/\1 \1d/g' $@

示例中file1.c生成的file1.d内容会变为：

file1.o: file1.c shared.h shared.hd
shared.h:
shared.hd:

3. 纳入全局依赖管理 #

将所有头文件的.hd文件纳入Makefile的全局构建目标，确保编译前预先生成所有头文件依赖：

# 递归查找所有头文件
HEADERS := $(shell find . -name "*.h")
# 生成对应的.hd文件列表
HEADER_DEPS := $(HEADERS:.h=.hd)
# 定义最终目标，确保先生成所有.hd再编译源文件
all: $(HEADER_DEPS) $(OBJECTS)

# 包含所有.d和.hd文件，让Makefile感知依赖
-include $(HEADER_DEPS) $(OBJECTS:.o=.d)

效果说明 #

• 首次构建时，GCC会扫描所有头文件生成.hd，所有源文件生成.d，这一步是一次性开销。
• 当修改shared.h时：
  1. Makefile检测到shared.h变化，重新生成shared.hd（仅扫描shared.h一次）。
  2. 所有依赖shared.hd的.o文件（如file1.o、file2.o）会触发重新编译，无需重新扫描file1.c、file2.c来更新依赖。
• 当修改1.h时：
  1. 先重新生成1.hd，再触发依赖1.hd的shared.hd重新生成，最后触发所有依赖shared.hd的.o编译，全程仅扫描1.h和shared.h各一次。

优势 #

• 完全兼容GCC的预定义宏、C23动态包含等新特性，解决makedepend过时的问题。
• 头文件仅扫描一次，依赖更新时间随头文件数量线性增长，而非源文件数量，大幅降低超大规模项目的依赖维护成本。
• 无需替换现有Makefile构建流程，仅需添加上述规则即可集成。

内容的提问来源于stack exchange，提问作者dash-o