我明白你现在在配置C++20模块的CMake构建时肯定头疼坏了——把接口和实现分开写之后，CMake和GCC的配合总是出各种状况：一会儿找不到模块缓存，一会儿CMake又报错源文件类型不对。我来帮你梳理下正确的配置方式，解决你遇到的这些问题。

首先得搞清楚核心问题：GCC的C++模块里，实现文件（模块单元，非接口/分区）不需要放到CXX_MODULES的FILE_SET中，这个FILE_SET是专门用来放模块接口单元和分区的，实现文件就是普通的源文件，但要确保它能正确识别模块关键字，同时依赖接口模块的构建产物。

正确的CMakeLists.txt配置 #

我直接给你能跑通的完整配置，再一步步解释：

cmake_minimum_required(VERSION 3.28)
project(ModuleTestProject LANGUAGES CXX)

add_library(moduleTest)

# 1. 把模块接口文件放到CXX_MODULES的FILE_SET中
target_sources(moduleTest
  PRIVATE
    FILE_SET CXX_MODULES FILES ModuleTest.ixx
)

# 2. 把实现文件作为普通PRIVATE源文件添加
target_sources(moduleTest PRIVATE ModuleTest.cpp)

# 3. 强制启用C++20标准
target_compile_features(moduleTest PUBLIC cxx_std_20)

# 4. 给所有源文件添加GCC模块支持的编译选项
target_compile_options(moduleTest PRIVATE -fmodules-ts)

为什么这个配置能解决你的问题？ #

咱们对应你遇到的错误逐个说：

1. 为什么不能把实现文件放到FILE_SET里？
   CMake的CXX_MODULES FILE_SET只接受模块接口单元（带export module的文件）和分区单元，你的ModuleTest.cpp是模块的实现单元，只有module moduleTest;声明，没有导出接口，所以CMake会报错“does not provide a module interface unit or partition”，这是完全符合规则的，所以实现文件必须作为普通源文件添加。

2. 为什么必须加-fmodules-ts？
   GCC默认是不启用C++模块支持的，这个选项是打开模块特性的开关，不管是接口文件还是实现文件，都需要这个选项才能识别module关键字。把它加到target_compile_options的PRIVATE里，就能确保这个库的所有源文件都用上这个编译选项。

3. 为什么之前会报“failed to read compiled module”？
   你之前的配置里，CMake没有正确处理接口文件和实现文件的依赖顺序。用上面的配置后，CMake会自动识别到实现文件依赖接口模块的构建产物（也就是gcm.cache里的.gcm文件），会先编译接口文件生成缓存，再编译实现文件，从根源上解决这个找不到模块缓存的错误。

额外注意点 #

• 你用的Ninja生成器非常合适，它对C++模块的依赖处理比Makefile生成器靠谱得多，继续用就好。
• GCC 14.2的模块支持已经比较成熟了，gcm.cache是它自动生成的模块缓存目录，CMake会帮你管理，别手动去改或者删除它。
• 如果你更习惯用标准属性来设置C++版本，也可以把target_compile_features换成下面的代码，效果是一样的：

  set_target_properties(moduleTest PROPERTIES
    CXX_STANDARD 20
    CXX_STANDARD_REQUIRED YES
    CXX_EXTENSIONS NO
  )
  

内容来源于stack exchange