如何基于GNU Make实现C++20模块的自动化构建？

GCC对C++20模块的支持需要区分模块接口编译与普通源文件编译，且必须保证模块接口先于依赖它的文件编译。我们可以通过Make的自动依赖生成和模式规则，实现无需手动维护模块依赖的自动化构建，以下是具体方案：

1. 区分模块与普通源文件 #

C++20模块接口文件推荐使用.cppm后缀（GCC官方偏好格式），普通源文件保留.cpp，先定义相关变量并自动搜索文件：

# 定义文件后缀
SOURCE_EXTENSION := cpp
MODULE_EXTENSION := cppm

# 自动搜索所有源文件和模块接口文件
SOURCES := $(shell find $(SOURCE_DIRECTORY) -type f -name *.$(SOURCE_EXTENSION))
MODULE_SOURCES := $(shell find $(SOURCE_DIRECTORY) -type f -name *.$(MODULE_EXTENSION))

# 生成目标文件路径：模块编译会产出.gcm（GCC模块缓存）和.o文件
OBJECTS := $(patsubst $(SOURCE_DIRECTORY)/%,$(OBJECT_DIRECTORY)/%,$(SOURCES:.$(SOURCE_EXTENSION)=.o))
MODULE_OBJECTS := $(patsubst $(SOURCE_DIRECTORY)/%,$(OBJECT_DIRECTORY)/%,$(MODULE_SOURCES:.$(MODULE_EXTENSION)=.o))
MODULE_GCMS := $(MODULE_OBJECTS:.o=.gcm)

# 编译标志：添加C++20和模块支持参数
COMPILATION_FLAGS := -g -Wall -std=c++20
MODULE_COMPILE_FLAGS := $(COMPILATION_FLAGS) -fmodules-ts
# 普通源文件编译时需指定模块缓存搜索路径
SOURCE_COMPILE_FLAGS := $(COMPILATION_FLAGS) -fmodules-ts -I$(OBJECT_DIRECTORY)

2. 模块接口编译规则 #

模块接口编译需要生成.gcm缓存文件，同时自动生成依赖文件确保构建顺序：

# 编译模块接口文件，生成.o和.gcm
$(OBJECT_DIRECTORY)/%.o: $(SOURCE_DIRECTORY)/%.$(MODULE_EXTENSION)
	@mkdir -p $(dir $@)
	$(GCC) $(MODULE_COMPILE_FLAGS) $(INCLUDES) -c -o $@ $<
	# 自动生成模块依赖文件
	$(GCC) $(MODULE_COMPILE_FLAGS) -MM -MF $(@:.o=.d) -MT $@ $<

3. 普通源文件编译规则 #

普通源文件需依赖模块缓存，同样生成自动依赖文件：

# 编译普通源文件
$(OBJECT_DIRECTORY)/%.o: $(SOURCE_DIRECTORY)/%.$(SOURCE_EXTENSION)
	@mkdir -p $(dir $@)
	$(GCC) $(SOURCE_COMPILE_FLAGS) $(INCLUDES) -c -o $@ $<
	# 自动生成普通源文件依赖文件
	$(GCC) $(SOURCE_COMPILE_FLAGS) -MM -MF $(@:.o=.d) -MT $@ $<

4. 整合目标与依赖 #

将所有目标文件整合到最终构建目标，并引入自动生成的依赖文件，让Make自动处理构建顺序：

# 最终目标：依赖所有普通目标文件和模块目标文件
$(TARGET): $(OBJECTS) $(MODULE_OBJECTS)
	@mkdir -p $(BINARY_DIRECTORY)
	$(GCC) $^ -o $(BINARY_DIRECTORY)/$(TARGET)

# 引入自动生成的依赖文件，确保模块优先编译
-include $(OBJECTS:.o=.d) $(MODULE_OBJECTS:.o=.d)

# 可选：清理构建产物
clean:
	rm -rf $(OBJECT_DIRECTORY) $(BINARY_DIRECTORY)

关键注意事项 #

• 自动依赖机制：通过-MM和-MF生成的.d文件会记录文件间的依赖关系，Make会自动据此调整编译顺序，无需手动维护模块依赖。
• GCC版本要求：必须使用GCC 11及以上版本，更早版本对C++20模块的支持存在缺陷。
• 后缀兼容：如果项目使用其他模块接口后缀（如.ixx），只需修改MODULE_EXTENSION变量即可。

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