如何在CMake项目中正确添加C++模块分区实现文件？

错误核心原因：C++模块的实现单元（即你的platform.win32-window.cpp）不能作为普通PRIVATE源文件添加，必须归入CXX_MODULES类型的FILE_SET中——CMake需要跟踪模块的所有单元（接口+实现）才能正确处理模块依赖关系。

正确配置示例 #

将实现文件添加到CXX_MODULES FILE_SET的PRIVATE部分，修改后的CMake代码如下：

target_sources(discovery_win32
        FILE_SET cxx_modules TYPE CXX_MODULES
        BASE_DIRS "${CMAKE_CURRENT_SOURCE_DIR}"
        FILES
        # 公开的模块接口文件
        PUBLIC "platform.win32.ixx" "platform.win32-window.ixx"
        # 私有模块实现文件
        PRIVATE "platform.win32-window.cpp")

配置说明 #

• BASE_DIRS：指定模块文件的基础目录，帮助CMake正确解析模块的路径结构（可选，但建议添加以避免路径相关问题）。
• PUBLIC标记的文件：是模块的接口单元（包含export module声明），会暴露给依赖此目标的其他项目。
• PRIVATE标记的文件：是模块的实现单元（包含module声明但无export），仅用于当前目标编译，不对外暴露。

如果需要拆分写法，也可以分两次调用target_sources：

# 添加公开模块接口
target_sources(discovery_win32
        PUBLIC
        FILE_SET cxx_modules TYPE CXX_MODULES
        FILES "platform.win32.ixx" "platform.win32-window.ixx")

# 添加私有模块实现
target_sources(discovery_win32
        PRIVATE
        FILE_SET cxx_modules TYPE CXX_MODULES
        FILES "platform.win32-window.cpp")

配置完成后，CMake会正确识别实现单元所属的模块分区，解决报错问题。

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