Mac下CLion 2023.3编译C++20模块失败，求解决方案

问题场景 #

代码结构如下：

// Hello.cppm
#include <iostream>
export module Hello;
export void hello() {
    std::cout << "Hello World!\n";
}

// main.cpp
import Hello;
int main() {
    hello();
    return 0;
}

编译时触发以下错误：

error: module interface compilation requires '-std=c++20' or '-fmodules-ts'
error: unknown type name 'import'
error: use of undeclared identifier 'hello'

手动预编译模块成功，但编译main.cpp时仍出现上述import和hello相关错误。环境为macOS Sonoma 14.2.1，clang版本15，CLion使用捆绑的cmake 3.27.8。

解决方案 #

一、CLion中通过CMake正确配置 #

1. 修改CMakeLists.txt，添加C++20标准和模块支持，规范模块编译逻辑：

cmake_minimum_required(VERSION 3.27)
project(HelloModule)

# 启用C++20标准及模块支持
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fmodules-ts")

# 定义模块库
add_library(HelloModule STATIC)
target_sources(HelloModule
    PUBLIC
        FILE_SET CXX_MODULES FILES Hello.cppm
)

# 编译主程序并链接模块
add_executable(Hello main.cpp)
target_link_libraries(Hello PRIVATE HelloModule)

2. 同步CMake配置：点击CLion界面中的「Reload CMake Project」按钮，确保配置生效。
3. 验证工具链：通过Settings > Build, Execution, Deployment > Toolchains确认CLion使用的clang版本为15，cmake版本保持3.27.8即可。

二、修正手动编译命令 #

之前编译main.cpp时遗漏了-fmodules-ts参数，正确命令如下：

1. 预编译模块：

clang++ -std=c++20 -fmodules-ts Hello.cppm --precompile -o Hello.pcm

2. 编译并链接主程序：

clang++ -std=c++20 -fmodules-ts main.cpp -fmodule-file=Hello=Hello.pcm -o Hello.out

无需重复添加Hello.pcm，-fmodule-file参数已指定模块文件路径。

额外注意事项 #

• 确保macOS的Xcode Command Line Tools为最新版本，可通过xcode-select --install更新。
• 若CLion仍有缓存报错，执行File > Invalidate Caches... > Invalidate and Restart清理缓存。

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