使用clang++编译C++20模块时，如何解决模块间依赖导入失败问题？

编译module_b.pcm时出现fatal error: module 'module_a' not found，核心原因是Clang编译模块依赖时，不会自动在当前目录搜索已预编译的.pcm文件，必须显式告知编译器依赖模块的位置。以下是完整的解决步骤：

正确编译流程 #

1. 预编译module_a生成.pcm文件 #

这一步你已执行成功，命令如下：

clang++ -fmodules-ts --precompile module_a.cppm -o module_a.pcm

2. 预编译module_b时指定依赖的module_a模块 #

有两种方式可让编译器找到module_a：

方式一：直接指定模块文件路径

使用-fmodule-file=<模块名>=<.pcm文件路径>参数，明确告知编译器module_a对应的.pcm文件位置：

clang++ -fmodules-ts --precompile module_b.cppm -o module_b.pcm -fmodule-file=module_a=module_a.pcm

方式二：设置模块搜索路径

通过-Xclang -fmodule-search-path=<路径>参数，将.pcm文件所在目录加入模块搜索路径，编译器会自动在该目录下查找对应模块的.pcm文件：

clang++ -fmodules-ts --precompile module_b.cppm -o module_b.pcm -Xclang -fmodule-search-path=.

3. 将.pcm文件编译为目标文件（.o） #

分别编译两个模块的.pcm文件：

# 编译module_a.pcm为.o
clang++ -fmodules-ts -c module_a.pcm -o module_a.o

# 编译module_b.pcm为.o
clang++ -fmodules-ts -c module_b.pcm -o module_b.o

4. 编译主程序并链接生成可执行文件 #

假设存在主程序文件main.cpp：

import module_b;
#include <iostream>

int main() {
    std::cout << B_Namespace::B_Export << std::endl;
    return 0;
}

编译主程序时需指定依赖的模块文件，再链接所有目标文件：

# 编译main.cpp为.o
clang++ -fmodules-ts -c main.cpp -o main.o -fmodule-file=module_b=module_b.pcm

# 链接生成可执行文件
clang++ module_a.o module_b.o main.o -o main

关键说明 #

C++20模块的编译模型和传统头文件完全不同：

• 传统头文件是文本包含，编译器会自动在当前目录和系统路径搜索头文件；
• 模块是预编译二进制单元（.pcm文件），编译器不会默认搜索当前目录的.pcm文件，必须通过参数显式指定模块文件或搜索路径。

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