如何让g++为GNU make自动生成C++导入模块的依赖规则

解决方案 #

GCC 11及以上版本已经内置了C++模块依赖的自动扫描能力，搭配GNU make的自动依赖逻辑即可实现无需手动编写每个头单元的规则，配置步骤如下：

1. 基础编译参数配置

所有编译环节统一添加如下参数：

• 基础模块支持：-std=c++20 -fmodules-ts
• 自动依赖生成：-MMD -MP
  开启-fmodules-ts的前提下，-MMD会自动扫描源文件中的import语句，将依赖的.gcm路径写入对应.d依赖文件，和传统#include的依赖生成逻辑完全兼容。

2. 编写系统头单元预编译的通用规则

不需要为每个系统头单独写规则，直接添加一条模式规则匹配所有gcm.cache下的.gcm文件即可：

# 系统头单元预编译通用规则
gcm.cache/%.gcm: %
	@mkdir -p $(dir $@)
	g++ -xc++-system-header -std=c++20 -fmodules-ts $<

3. 导入自动生成的依赖文件

和处理传统#include依赖的逻辑一致，把生成的.d文件导入Makefile：

# 替换为你项目的实际源文件列表
SRCS := $(wildcard *.cpp)
OBJS := $(SRCS:.cpp=.o)
# 自动生成的依赖文件列表
DEPS := $(OBJS:.o=.d)

# 导入所有依赖文件，不存在则忽略
-include $(DEPS)

# 普通源文件编译规则
%.o: %.cpp
	g++ -std=c++20 -fmodules-ts -MMD -MP -c $< -o $@

# 最终链接规则
your_target: $(OBJS)
	g++ -std=c++20 -fmodules-ts $^ -o $@

注意事项

• 该功能仅GCC 11及以上版本支持，低版本GCC没有内置模块依赖扫描能力，无法实现自动生成。
• 所有编译、预编译环节的-std版本、-fmodules-ts参数必须完全一致，参数不匹配的.gcm文件不会被GCC识别，会导致重复编译或报错。
• 自定义命名模块的依赖也可以用该逻辑自动生成，只要补充对应模块的编译规则即可。

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