C++ Modules开发中遭遇'multiple definition'链接错误的问题排查求助

这个问题其实是GCC早期对C++20 Modules TS实验性支持的常见坑——当多个模块都通过import <iostream>引入标准库时，会导致标准库中的核心函数（比如std::string的构造/析构函数）被多次生成定义，链接阶段就会触发重复定义的错误。下面给你几个可行的解决办法：

方法一：分步编译模块接口 #

GCC处理模块时需要先单独编译每个模块的接口单元，生成模块缓存文件（.gcm），这样多个模块共享标准库符号时不会重复生成定义。执行以下命令：

1. 编译module_a的接口：

g++ -std=c++20 -fmodules-ts -c module_a.cpp

2. 编译module_b的接口：

g++ -std=c++20 -fmodules-ts -c module_b.cpp

3. 编译main.cpp并链接所有目标文件：

g++ -std=c++20 -fmodules-ts main.cpp module_a.o module_b.o

方法二：改用传统#include引入标准库 #

如果分步编译还是不行，在模块的全局模块片段（module;之后的部分）里，把import <iostream>换成传统的#include <iostream>：

修改后的module_a.cpp：

module;
#include <iostream> // 替换import <iostream>
export module module_a;

export void test_a() {
    std::cout << std::string("test module a\n");
}

module_b.cpp做同样修改后，再用分步编译或直接编译的方式，就能避开重复定义的问题。

额外建议 #

GCC 11的模块支持还处于实验阶段，对标准库的import处理存在不少缺陷。如果条件允许，建议升级到GCC 12及以上版本，这些版本对C++20模块的支持更贴合标准，也修复了大量类似的链接问题。

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