头文件未改动时Makefile仍全量编译问题如何解决？

核心原因 #

• create_header目标无对应同名产出文件，每次执行make时都会被判定为需要重新构建，强制触发create_headers.sh脚本运行。如果脚本未做内容一致性校验，每次运行都会覆盖生成的头文件、更新其修改时间，而所有.o目标都依赖$(IDIR)下的头文件，最终触发全量编译。
• environment.o错误依赖了所有业务对象文件$(OBJ)，编译阶段不需要依赖其他.o文件，该错误规则会导致任意.o更新都会触发environment.o重编译。

修复步骤 #

1. 改造create_header目标避免重复执行 #

新增时间戳标记文件，仅当create_headers.sh本身修改时才重新执行脚本，同时避免无意义的头文件时间戳更新：

# 替换原有create_header规则
create_header: .header_gen_timestamp

.header_gen_timestamp: create_headers.sh
	chmod +x $<
	bash $<
	@touch $@

# 同步更新.PHONY声明
.PHONY: clean create_header git_upload

2. 优化create_headers.sh逻辑 #

修改脚本，仅当生成的头文件内容发生变化时才覆盖原有文件，避免修改未变动头文件的时间戳：

# 示例脚本逻辑，根据实际生成的头文件路径修改即可
OUTPUT="lib/autogen.hh"
TEMP="autogen.tmp"

# 先生成内容到临时文件
cat > ${TEMP} << EOF
// 你的自动生成头文件内容
EOF

# 对比内容，仅不同时替换
if ! diff -q ${TEMP} ${OUTPUT} >/dev/null 2>&1; then
    mv ${TEMP} ${OUTPUT}
else
    rm ${TEMP}
fi

3. 修正environment.o的依赖规则 #

移除编译阶段不必要的.o依赖，仅保留源文件和头文件依赖：

# 替换原有environment.o规则
environment.o: environment.cpp $(DEPS)
	$(CXX) -c -o $@ $< $(CFLAGS)

4. 可选优化：新增obj目录自动创建 #

避免第一次编译时因obj目录不存在报错：

# 给所有.o生成规则增加目录依赖
$(ODIR)/%.o: $(UDIR)/%.cpp $(DEPS) | $(ODIR)
	$(CXX) -c -o $@ $< $(CFLAGS) 

$(ODIR)/%.o: $(CDIR)/%.cpp $(DEPS) | $(ODIR)
	$(CXX) -c -o $@ $< $(CFLAGS) 

$(ODIR):
	mkdir -p $@

内容的提问来源于stack exchange，提问作者J. P. C.