Makefile仅序依赖规则重复执行问题排查

嘿，我来帮你排查这个问题！首先看你的描述和代码片段，核心问题是你设置的$(TEST_LOGGED)序依赖规则被重复触发了，日志里多次出现相关输出，这大概率是几个常见的Makefile坑导致的，咱们一步步捋：

最可能的元凶：标记文件根本没被创建 #

你看你写的$(TEST_LOGGED)规则，里面只有$(ECHO)输出，但没有创建$(TEST_LOGGED)这个标记文件的步骤啊！

Make的逻辑是这样的：如果一个目标文件不存在，不管是不是序依赖，它都会尝试去构建这个目标。如果你的规则执行完后，$(BUILD_DIR)/.metadata_logged这个文件还是没出现在磁盘上，那下次编译任何.c/.cpp文件时，Make都会觉得“这个序依赖目标还没完成，我得再跑一遍规则”，自然就会重复输出日志了。

解决这个问题的关键，就是在$(TEST_LOGGED)的规则最后，加上创建标记文件的命令：

$(TEST_LOGGED): | $(METADATA_DIR)
    $(ECHO) "Saving CFLAGS to $(CFLAGS_FILE)"
    $(ECHO) "$(__CFLAGS__)" > $(CFLAGS_FILE)
    $(ECHO) "Saving CXXFLAGS to $(CXXFLAGS_FILE)"
    $(ECHO) "$(__CXXFLAGS__)" > $(CXXFLAGS_FILE)
    touch $@  # 这一步必须加！创建标记文件告诉Make任务完成

次要排查点：变量定义顺序有问题 #

看你的变量定义：

CFLAGS_FILE := $(METADATA_DIR)/cflags.txt
CXXFLAGS_FILE := $(METADATA_DIR)/cxxflags.txt

METADATA_DIR :=  $(BUILD_DIR)

你用的是:=（立即展开），所以CFLAGS_FILE和CXXFLAGS_FILE在定义时，$(METADATA_DIR)还没被赋值，会被展开成空字符串！虽然这可能暂时不影响$(TEST_LOGGED)的触发，但后续如果要生成cflags.txt和cxxflags.txt的话，路径会出问题。

赶紧把变量顺序调整一下，把基础目录变量放在最前面：

# 先定义基础目录，确保后续变量能正确展开
METADATA_DIR :=  $(BUILD_DIR)
CFLAGS_FILE := $(METADATA_DIR)/cflags.txt
CXXFLAGS_FILE := $(METADATA_DIR)/cxxflags.txt

额外检查项 #

• 确认$(BUILD_DIR)确实被正确创建了：你的$(TEST_LOGGED)规则有个序依赖$(METADATA_DIR)，要确保这个目录的创建规则是正常工作的，比如如果$(METADATA_DIR)对应的规则里用了mkdir -p这类能创建多级目录的命令。
• 检查命令是否执行成功：如果生成cflags.txt的命令失败了，而且你没做错误处理，同时标记文件也没创建，那Make还是会重复触发规则。可以在关键命令后加&&确保只有前面成功才创建标记文件，比如：

  $(TEST_LOGGED): | $(METADATA_DIR)
      $(ECHO) "$(__CFLAGS__)" > $(CFLAGS_FILE) && \
      $(ECHO) "$(__CXXFLAGS__)" > $(CXXFLAGS_FILE) && \
      touch $@
  

按上面的步骤调整后，你的序依赖规则应该只会执行一次了。

备注：内容来源于stack exchange，提问作者kathy