C++20模块自动依赖生成及Makefile规则配置求助

问题背景 #

在使用C模块的项目中，需要自动管理依赖关系。传统头文件引用可通过g++ -M或g++ -MM生成依赖，但C模块的依赖处理方式不同。示例项目包含两个文件：

模块文件 f1.cpp #

export module f1module;
import <iostream>;

export void f1()
{
    std::cout << "Check" << std::endl;
}

主程序文件 main.cpp #

import <iostream>;
import <sstream>;
import f1module;

int main()
{
    std::ostringstream os;
    os << "Test"; 
    std::cout << os.str() << std::endl;
    f1();
}

尝试传统依赖生成命令时遇到警告：

$ g++ -fmodules-ts -std=c++26 -M f1.cpp
<built-in>: warning: module dependencies require preprocessing
<built-in>: note: you should use the '-MD' option
f1.o: f1.cpp /usr/include/stdc-predef.h

使用-MD但未添加编译限制时，出现链接错误：

$ g++ -fmodules-ts -std=c++26 -MD f1.cpp
/usr/bin/ld: /usr/lib/gcc/x86_64-redhat-linux/14/../../../../lib64/crt1.o: in function `_start':
(.text+0x1b): undefined reference to `main'
collect2: error: ld returned 1 exit status

解决方法：编写Makefile生成gcm文件 #

GCC处理C++模块需分两步：先编译模块接口生成.gcm（GCC模块编译）文件，再编译主程序并链接。以下是完整的Makefile规则：

完整Makefile示例 #

# 定义编译器和编译选项
CC = g++
CFLAGS = -fmodules-ts -std=c++26 -MD

# 目标：生成可执行文件main
main: main.o f1module.gcm
	$(CC) $(CFLAGS) main.o -o main

# 编译主程序生成目标文件
main.o: main.cpp f1module.gcm
	$(CC) $(CFLAGS) -c main.cpp -o main.o

# 编译模块接口生成gcm文件
f1module.gcm: f1.cpp
	$(CC) $(CFLAGS) -c $< -o $@

# 自动包含生成的依赖文件
-include *.d

规则说明 #

1. 编译选项：

   • -fmodules-ts：启用C++模块支持（GCC的模块实现基于TS标准）
   • -std=c++26：指定C++标准（也可使用c++20，只要编译器支持模块即可）
   • -MD：自动生成对应目标的依赖文件（如f1module.gcm.d、main.o.d），包含模块的完整依赖关系

2. 模块编译规则：

   • f1module.gcm依赖f1.cpp，使用-c参数只编译不链接，GCC会根据模块声明export module f1module;生成对应名称的.gcm文件

3. 主程序编译规则：

   • main.o依赖main.cpp和f1module.gcm，确保编译主程序时能找到模块的编译表示
   • 最终链接main.o生成可执行文件main

4. 依赖自动管理：

   • -include *.d会引入所有自动生成的.d文件，Makefile会根据这些文件自动处理模块的依赖更新

执行方式 #

在项目目录下运行make，会自动完成以下步骤：

1. 编译f1.cpp生成f1module.gcm和依赖文件f1module.gcm.d
2. 编译main.cpp生成main.o和依赖文件main.o.d
3. 链接生成可执行文件main

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