如何用CMake+Clang构建支持C++23标准库模块(import std)的项目？

关键原因 #

Clang 17的标准库模块属于实验性特性，默认未启用，且需要显式指定使用libc++（GCC的libstdc++暂不支持该模块），同时原CMake配置存在两处错误：

• 将普通源文件main.cpp放入了CXX_MODULES类型的FILE_SET中
• 未添加启用实验性标准库模块的编译选项

修正后的CMakeLists.txt #

CMAKE_MINIMUM_REQUIRED(VERSION 3.27)

set(CMAKE_EXPERIMENTAL_CXX_MODULE_CMAKE_API "aa1f7df0-828a-4fcd-9afc-2dc80491aca7")
set(CMAKE_EXPERIMENTAL_CXX_MODULE_DYNDEP ON)

set(CMAKE_CXX_EXTENSIONS OFF)
set(CMAKE_CXX_STANDARD 23)
# 指定使用libc++，这是Clang标准库模块的依赖前提
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -stdlib=libc++ -fexperimental-library")
# 若系统未默认使用Clang 17，需显式指定编译器路径
# set(CMAKE_CXX_COMPILER "/path/to/clang++-17")

project(1-1)

add_executable(${CMAKE_PROJECT_NAME})
# 普通源文件直接添加，无需放入CXX_MODULES的FILE_SET
target_sources(${CMAKE_PROJECT_NAME}
    PRIVATE
    main.cpp
)
# 若有自定义模块文件，再添加FILE_SET，示例：
# target_sources(${CMAKE_PROJECT_NAME}
#     PUBLIC
#     FILE_SET all_my_modules TYPE CXX_MODULES FILES
#     your_custom_module.cppm
# )

额外说明 #

• -fexperimental-library：启用Clang的实验性标准库特性，包含P2465R3定义的标准库模块
• -stdlib=libc++：强制使用LLVM的libc++标准库，这是支持import std;的必要条件
• 若系统未安装libc++，需先安装对应开发包（如Ubuntu下的libc++-17-dev和libc++abi-17-dev）

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