如何使用Makefile实现C++ modules项目的自动编译构建

你遇到的是GCC C++20模块编译的前置依赖问题：模块接口单元需要先编译生成对应的二进制模块文件（.gcm），普通源文件才能导入使用。可以通过调整Makefile实现全自动编译，无需手动提前处理模块。

调整后的完整Makefile #

OUT = example
INSTALL_DIR = /usr/local/bin

OBJECT = ./obj
SOURCE = ./src
MODULE_CACHE = ./gcm # 模块缓存目录，统一存放生成的.gcm模块文件

# 区分普通源文件和模块接口文件，约定模块接口使用.ccm后缀
SRC := $(shell find $(SOURCE) -name *.cc)
MODULE_SRC := $(shell find $(SOURCE) -name *.ccm)
MODULE_OBJ := $(MODULE_SRC:%=$(OBJECT)/%.o)
OBJ := $(SRC:%=$(OBJECT)/%.o) $(MODULE_OBJ)
DEPS := $(OBJ:.o=.d)

INC_DIRS := $(shell find $(SOURCE) -type d)
INC_FLAGS := $(addprefix -I,$(INC_DIRS))
MODULE_FLAGS := -fmodule-path=$(MODULE_CACHE) # 指定模块查找路径

CXX = g++ # 修正为C++专用编译器，避免误用gcc编译C++代码
CXXFLAGS = -pipe -fmodules-ts -std=c++20 $(INC_FLAGS) $(MODULE_FLAGS)
DEBUG_FLAGS := $(CXXFLAGS) -g -Wall -Wextra
RELEASE_FLAGS := $(CXXFLAGS) -O3 -flto

# 自动创建必要目录
$(shell mkdir -p $(MODULE_CACHE))

debug: $(OBJ)
    @echo "Building the DEBUG binary..."
    @$(CXX) $(OBJ) -o $(OUT) $(DEBUG_FLAGS)
    @echo "The binary was built successfully!"

release: $(OBJ)
    @echo "Building the RELEASE binary..."
    @$(CXX) $(OBJ) -o $(OUT) $(RELEASE_FLAGS)
    @echo "The binary was built successfully!"

install: $(OUT)
    @cp $(OUT) $(INSTALL_DIR)

uninstall:
    @rm $(INSTALL_DIR)/$(OUT)

# 模块接口文件编译规则
$(OBJECT)/%.ccm.o: %.ccm
    @mkdir -p $(dir $@)
    @echo "Building module $@..."
    @$(CXX) $(CXXFLAGS) -c $< -o $@

# 普通源文件编译规则，依赖模块编译完成
$(OBJECT)/%.cc.o: %.cc $(MODULE_OBJ)
    @mkdir -p $(dir $@)
    @echo "Building $@..."
    @$(CXX) $(CXXFLAGS) -c $< -o $@

.PHONY: clean

clean:
    rm -rf $(OBJECT) $(OUT) $(MODULE_CACHE)

-include $(DEPS)

核心修改说明 #

• 新增独立的模块缓存目录，所有生成的模块文件统一存放，避免污染源码目录
• 新增模块接口专属编译规则，保证模块先于普通源文件编译完成
• 新增模块查找路径参数，编译器可以自动定位已生成的模块文件
• 清理规则新增模块缓存删除逻辑，避免旧模块残留导致编译异常

注意事项 #

• 如果你习惯用.cc作为模块接口文件后缀，只需把模块规则里的.ccm改成.cc即可，不过建议模块接口和普通实现文件用不同后缀区分，减少不必要的重复编译
• 确保使用的GCC版本 >= 11，低版本对C++20模块的支持不完善
• 如果项目中存在模块间的互相依赖，需要额外添加模块的依赖声明，避免并行编译时出现找不到模块的问题

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