如何编写顶层Makefile，实现子模块源码修改后自动重建？

你的思路方向是对的，但当前方案存在一个明显问题：submodule/build/submodule_target依赖.PHONY的build-submodule，这会导致每次执行顶层make时，不管子模块文件有没有变化，都会强制触发子模块的构建——因为PHONY目标总是被标记为"过期"，完全失去了make的增量构建优势。

下面是几种更合理的优化方案，适配子模块Makefile复杂、依赖难梳理的场景：

方案1：基于子模块关键文件的依赖触发（推荐） #

不需要深入子模块的内部依赖，只需要让顶层Makefile监控子模块的核心变更源：子模块的Makefile，以及所有源码文件。用wildcard可以快速匹配所有源码，不用手动逐个列举：

# 匹配子模块下所有源码文件，可根据实际目录结构调整（比如submodule/src/**/*.c）
SUBMODULE_SOURCES := $(wildcard submodule/src_* submodule/src/*.c submodule/src/**/*.h)
SUBMODULE_MAKEFILE := submodule/Makefile

# 最终目标依赖自身源码和子模块产物
build/finial_target: src_1 submodule/build/submodule_target
    # 这里写生成最终目标的命令，比如链接操作
    gcc $^ -o $@

# 子模块产物依赖其源码和Makefile，变更时触发子模块构建
submodule/build/submodule_target: $(SUBMODULE_SOURCES) $(SUBMODULE_MAKEFILE)
    $(MAKE) -C submodule

这个方案的优势是：

• 只有当子模块的源码或Makefile真的修改时，才会触发子模块的make
• 不需要了解子模块内部的复杂依赖关系
• 保留了make的增量构建特性，避免无用功

方案2：极简递归构建（适合完全信任子模块Makefile的场景） #

如果完全信任子模块的Makefile能正确处理自身的增量构建，也可以简化成下面的写法：

.PHONY: all clean

all: build/finial_target

build/finial_target: src_1
    # 先确保子模块产物最新，再构建最终目标
    $(MAKE) -C submodule
    gcc src_1 submodule/build/submodule_target -o $@

clean:
    rm -f build/finial_target
    $(MAKE) -C submodule clean

这种写法的特点是：

• 每次构建最终目标时，先调用子模块的make——但子模块自身的Makefile会检查依赖，只在需要时重建
• 写法最简单，但缺点是即使子模块没有变更，也会执行一次make -C submodule（不过子模块的make会快速跳过，因为没有过期目标）

关键注意事项 #

1. 用$(MAKE)而非直接make：这能传递顶层make的参数（比如-j4并行构建、V=1 verbose模式）给子模块，保证构建行为一致
2. 避免PHONY目标作为文件目标的依赖：这是你初始方案的核心问题，会彻底破坏增量构建
3. 联动清理规则：顶层的clean必须调用子模块的clean，否则会残留子模块的构建产物
4. 并行构建兼容性：如果使用-j并行构建，确保子模块的Makefile是可重入的（大多数正规Makefile都满足）

总结 #

优先选择方案1，它平衡了准确性和简洁性，既不需要深挖子模块的依赖，又能精准触发必要的重建；如果子模块的Makefile足够可靠，方案2的极简写法也能满足需求。

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