C++20模块编译咨询：Clang/GCC支持情况及正确编译方法

问题背景 #

尝试用Clang编译一个小型C++20模块，相关代码与编译信息如下：

模块代码（basic_math.cpp） #

//basic_math.cpp
export module basic.math; //注意模块名与文件名不同

int mysum(int x, int y) {  // 无export关键字表示模块内链接
  return x + y;
}

export int add(int x, int y) { return mysum(x, y); }

主程序代码（main.cpp） #

import basic.math;
#include <iostream>

int main()
{
    auto res = add(3, 5);
    std::cout << res << '\n';
    return 0;
}

使用的编译命令：

clang++ -std=c++20 -fmodules -fcxx-modules -nostdinc++ -isystem /opt/homebrew/opt/llvm/include/c++/v1 -x c++-module -c basic_math.cpp -o basic_math.pcm && clang++ -std=c++20 -fmodules -fcxx-modules -nostdinc++ -isystem /opt/homebrew/opt/llvm/include/c++/v1 -fmodule-file=basic_math.pcm -c main.cpp -o main.o && clang++ -std=c++20 -fmodules -fcxx-modules -nostdinc++ -isystem /opt/homebrew/opt/llvm/include/c++/v1 main.o -o main

编译报错：

fatal error: file 'basic_math.pcm' is not a valid precompiled module file: file too small to contain AST file magic
1 error generated.

使用的Clang版本：

Homebrew clang version 20.1.4
Target: arm64-apple-darwin24.4.0
Thread model: posix
InstalledDir: /opt/homebrew/Cellar/llvm/20.1.4_1/bin
Configuration file: /opt/homebrew/etc/clang/arm64-apple-darwin24.cfg

同时尝试GCC 14编译也未成功，现咨询两个问题：

1. C++20模块是否已被编译器妥善支持？
2. 上述代码的正确编译方式是什么？

解答 #

1. C++20模块的编译器支持情况 #

• Clang：从Clang 16开始，C20模块的支持已趋于完善，你使用的20.1.4版本完全支持标准C20模块特性，版本兼容性无问题。
• GCC：GCC 14对C++20模块的支持仍处于实验阶段，部分特性存在兼容性问题，编译时需添加-fmodules-ts参数启用实验性支持，但稳定性不如Clang。

2. 正确的编译方式 #

你的编译命令存在两个关键问题：手动指定的标准库路径干扰了模块编译，且错误使用了-x c++-module参数。以下是修正后的编译步骤：

Clang编译步骤

1. 编译模块生成PCM文件：

clang++ -std=c++20 -fmodules -c basic_math.cpp -o basic_math.pcm

2. 编译主程序并链接模块：

clang++ -std=c++20 -fmodules -fmodule-file=basic_math.pcm main.cpp -o main

也可以合并为一条命令，Clang会自动处理模块依赖：

clang++ -std=c++20 -fmodules basic_math.cpp main.cpp -o main

GCC 14编译步骤（实验性）

GCC模块编译流程与Clang不同，需先生成模块接口文件：

1. 生成模块接口文件：

g++ -std=c++20 -fmodules-ts -c basic_math.cpp -o basic_math.gcm

2. 编译主程序：

g++ -std=c++20 -fmodules-ts -fmodule-file=basic_math.gcm main.cpp -o main

注意：GCC的模块支持细节问题较多，优先推荐使用Clang进行C++20模块开发。

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