Makefile并行编译下等待文件可用的同步方案咨询

一、最佳同步方式：正确声明依赖关系 #

这是Make工具的核心设计目标，也是解决并行编译竞态的根本方案。

• 如果目标头文件foo/bar.h是由当前Makefile中的某个规则生成的，直接将它作为依赖添加到需要用到它的目标中：

  # 生成头文件的规则
  foo/bar.h:
  	@echo "Generating foo/bar.h..."
  	# 你的头文件生成命令（比如脚本、预编译工具等）
  
  # 需要用到头文件的编译目标
  my_compile_target: foo/bar.h
  	gcc -c src/my_file.c -o obj/my_file.o -Ifoo
  

  Make会自动保证在构建my_compile_target之前，先完成foo/bar.h的生成，完全避免并行带来的竞态。

• 如果头文件是由其他子目录的Makefile生成的，通过递归调用Make并将头文件作为依赖绑定：

  # 确保子Makefile先生成头文件
  foo/bar.h:
  	$(MAKE) -C ../header-generator all
  
  my_compile_target: foo/bar.h
  	# 编译命令
  

  这种方式会让Make处理跨Makefile的依赖顺序，比轮询更可靠、高效。

二、应急方案：实现文件轮询（不推荐） #

如果因项目结构限制无法直接声明依赖，也可以通过内嵌Shell命令实现轮询检查，直到文件出现或超时失败：

方式1：定义Make函数复用 #

# 定义轮询函数，参数1为目标文件路径，参数2为超时秒数（默认30）
define WAIT_FOR_FILE
	@timeout=$(if $(2),$(2),30); \
	count=0; \
	while [ ! -f "$(1)" ] && [ $$count -lt $$timeout ]; do \
		echo "Waiting for $(1)... ($$count/$$timeout)"; \
		sleep 1; \
		count=$$((count+1)); \
	done; \
	if [ ! -f "$(1)" ]; then \
		echo "ERROR: $(1) not found after $$timeout seconds" >&2; \
		exit 1; \
	fi
endef

# 使用示例
my_compile_target:
	$(call WAIT_FOR_FILE,foo/bar.h,60)  # 超时60秒
	gcc -c src/my_file.c -o obj/my_file.o -Ifoo

方式2：直接写入规则 #

my_compile_target:
	@timeout=30; \
	count=0; \
	while [ ! -f "foo/bar.h" ] && [ $$count -lt $$timeout ]; do \
		echo "Waiting for foo/bar.h... ($$count/$$timeout)"; \
		sleep 1; \
		count=$$((count+1)); \
	done; \
	if [ ! -f "foo/bar.h" ]; then \
		echo "ERROR: foo/bar.h not generated within $$timeout seconds" >&2; \
		exit 1; \
	fi
	gcc -c src/my_file.c -o obj/my_file.o -Ifoo

注意：轮询是临时 workaround，存在以下缺点：

• 会占用额外CPU资源，尤其是超时时间设置较长时
• 无法感知生成头文件的进程是否失败，只能被动等待超时
• 依赖声明才是符合Make设计理念的正统解决方式，优先推荐使用

内容的提问来源于stack exchange，提问作者Łukasz Przeniosło