如何实现Makefile多线程构建时单规则阻塞后续任务执行？

问题背景 #

我们有一套使用Makefile构建固件的系统，禁止推荐CMake等其他构建工具。构建过程中通过脚本基于master分支提交次数生成Git版本号并写入versions.h头文件。此前流程正常，直到给make设置-j多线程构建别名后出现问题：

• 干净构建时因versions.h缺失或不完整失败；
• 重复构建时固件显示上一次的构建日期。

相关代码片段 #

Makefile关键部分

.PHONY: all clean ... premake1

...

$(BUILD_DIR)/versions.h: premake1

premake1:
    "../../EXTERNALS/BuildUtils/GitVersion.sh" "$(BUILD_DIR)"

...

$(BUILD_DIR)/bin/trace.o: trace.c Makefile
    $(CC) $(OPTS) $(INC_OPTS) $(DEF_OPTS) -MM -MG -MP -MF "$(BUILD_DIR)/deps/trace.d" -MT "$(BUILD_DIR)/bin/trace.o" trace.c
    $(CC) $(OPTS) -Wa,-alhms="$(BUILD_DIR)/lst/trace.lst" $(INC_OPTS) $(DEF_OPTS) -c -o "$(BUILD_DIR)/bin/trace.o" trace.c

-include $(DEPENDENCIES)

trace.o的依赖文件内容

$(BUILD_DIR)/bin/trace.o: \
 trace.c $(BUILD_DIR)/versions.h \
 ... other files here too ...

versions.h:

核心问题 #

premake1规则与trace.o构建规则并行启动，导致trace.o及其依赖文件在versions.h生成前完成构建。虽然理论上trace.o依赖versions.h、versions.h依赖premake1，但并行模式下Make对PHONY目标的处理逻辑，打破了本应保证的执行顺序。

解决方法 #

方法1：直接绑定versions.h生成到文件规则 #

当前$(BUILD_DIR)/versions.h依赖PHONY目标premake1，Make会认为PHONY目标总是需要重建，但不会严格保证其在文件生成前完成。直接将脚本命令移到versions.h的规则中，让Make直接追踪文件依赖：

# 移除原有的premake1 PHONY规则及versions.h对它的依赖
.PHONY: all clean ...

...

$(BUILD_DIR)/versions.h:
    "../../EXTERNALS/BuildUtils/GitVersion.sh" "$(BUILD_DIR)"

...

这样Make会明确：生成versions.h必须执行脚本，所有依赖versions.h的目标会等待文件生成完成后再启动，从根本上解决并行冲突。

方法2：让all目标强制依赖premake1 #

如果必须保留premake1目标，修改all目标，让它先完成premake1再构建最终固件：

.PHONY: all clean ... premake1

all: premake1 firmware_target

firmware_target: $(BUILD_DIR)/bin/trace.o ...

premake1:
    "../../EXTERNALS/BuildUtils/GitVersion.sh" "$(BUILD_DIR)"

$(BUILD_DIR)/versions.h: premake1

这种方式会让Make在执行任何编译目标前，先完成premake1的执行，彻底避免并行冲突。

方法3：修复自动依赖文件的路径错误 #

自动生成的依赖文件中出现了versions.h:（缺少$(BUILD_DIR)前缀），这会让Make误认为存在当前目录下的versions.h，与实际生成的$(BUILD_DIR)/versions.h不是同一个文件，导致依赖关系失效。

检查-MM命令的输出，确保生成的依赖是$(BUILD_DIR)/versions.h。可以调整编译时的-I参数，或者修改脚本生成versions.h时的包含路径，让预处理器正确识别文件路径，生成带完整前缀的依赖项。

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