如何正确链接已编译的C++模块接口与目标文件？

我的项目结构如下：

.
├── animals.cpp
├── animals.cppm
├── gcm.cache
│   ├── animals.gcm
│   └── std.gcm
└── main.cpp

原本可通过以下命令直接编译链接：

g++ -std=c++26 -Wall -O2 -fmodules animals.cppm animals.cpp main.cpp -o animals

现在想拆分编译目标文件与链接步骤，执行了编译命令：

g++ -std=c++26 -Wall -O2 -fmodules animals.cppm animals.cpp main.cpp -c

命令执行成功，生成了animals.o和main.o文件，但执行链接命令时失败：

g++ -fmodules animals.o main.o -o animals

报错信息如下：

/usr/bin/x86_64-linux-gnu-ld.bfd: main.o: warning: relocation against `_ZTIN7animalsW7animals3CatE' in read-only section `.text.startup'
/usr/bin/x86_64-linux-gnu-ld.bfd: animals.o: in function `animals::Animal@animals::Animal(std::basic_string_view<char, std::char_traits<char> >)':
/home/dode/BeginningC++23/12-objects/animals.cpp:12:(.text+0x606): undefined reference to `vtable for animals::Animal@animals'
[...]
/usr/bin/x86_64-linux-gnu-ld.bfd: main.o: in function `_GLOBAL__sub_I_main':
/home/dode/BeginningC++23/12-objects/main.cpp:68:(.text.startup+0x1): undefined reference to `initializer for module animals'
/usr/bin/x86_64-linux-gnu-ld.bfd: warning: creating DT_TEXTREL in a PIE
collect2: error: ld returned 1 exit status

猜测遗漏了基础步骤，导致链接器无法识别已编译的模块接口，该如何解决？

问题出在拆分编译时，模块接口文件（.cppm）的编译产物未被正确处理。GCC处理C++模块时，直接编译所有文件会自动管理模块依赖与初始化代码，但拆分编译时需要单独编译模块接口，并确保所有相关目标文件都参与链接。

按以下步骤操作即可解决：

1. 单独编译模块接口文件
   先编译animals.cppm，生成模块对应的目标文件（避免后续编译覆盖，指定单独的输出文件名）：

   g++ -std=c++26 -Wall -O2 -fmodules -c animals.cppm -o animals_mod.o
   

   这一步会同时更新gcm.cache/animals.gcm缓存文件，确保其他源文件能正确引用模块接口。

2. 编译模块实现与主文件
   分别编译animals.cpp和main.cpp，此时它们会基于已编译好的模块接口进行编译：

   g++ -std=c++26 -Wall -O2 -fmodules -c animals.cpp -o animals_impl.o
   g++ -std=c++26 -Wall -O2 -fmodules -c main.cpp -o main.o
   

3. 链接所有目标文件
   链接时需包含模块接口、模块实现和主文件的所有目标文件，无需添加-fmodules参数：

   g++ animals_mod.o animals_impl.o main.o -o animals
   

原因说明 #

• 之前的错误是因为模块接口的目标文件未被包含在链接步骤中，导致链接器找不到模块的虚函数表（vtable）和初始化函数。
• 单独编译模块接口能确保模块的元数据与初始化代码被生成到目标文件中，后续源文件编译时可直接复用这些信息，最终链接时整合所有依赖即可生成可执行文件。

内容的提问来源于stack exchange，提问作者Torsten Römer