CMake3.28+C++20模块编译报错：wx类跨模块定义不一致

问题描述 #

使用CMake 3.28（支持C++20一等模块，搭配Clang >=17）构建项目时，出现wxDateTime的模块定义冲突错误：

[build] /usr/local/include/wx-3.3/wx/datetime.h:752:17: error: 'wxDateTime' has different definitions in different modules; first difference is defined here found method 'IsValid' with body
[build] 752 | inline bool IsValid() const { return m_time != wxLongLong(wxINT64_MIN); }
[build] | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
[build] /usr/local/include/wx-3.3/wx/datetime.h:752:17: note: but in 'HS.Debug.' found method 'IsValid' with different body
[build] 752 | inline bool IsValid() const { return m_time != wxLongLong(wxINT64_MIN); }
[build] | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

已尝试静态/动态链接重建、编译选项兼容性检查，问题仍未解决，以下是针对性解决思路：

解决方向 #

• 禁止模块导入与头文件包含混用
  C++20模块和传统#include混用是此类冲突的高发原因。确保wxWidgets的头文件要么通过模块导入（如import wx.core;），要么通过传统头文件包含，同一编译单元内不能同时使用两种方式。

• 验证wxWidgets对C++20模块的支持
  wxWidgets 3.3为开发版本，对C++20模块的支持可能不完善。确认是否有官方提供的模块构建配置，或是否需要手动生成wxWidgets的模块接口文件（.cppm），避免直接将传统头文件当作模块导入。

• 修正CMake模块配置
  确保CMake正确启用C++20模块支持，相关配置示例：

  set(CMAKE_CXX_STANDARD 20)
  set(CMAKE_CXX_STANDARD_REQUIRED ON)
  set(CMAKE_CXX_EXTENSIONS OFF)
  # 启用CMake实验性模块API
  set(CMAKE_EXPERIMENTAL_CXX_MODULE_CMAKE_API "2182bf5c-ef0d-489a-91da-49dbc3090d2a")
  set(CMAKE_EXPERIMENTAL_CXX_MODULE_DYNDEP 1)
  

  同时检查wxWidgets目标的属性，避免非模块目标与模块目标混合链接。

• 排查预编译头与重复编译单元
  预编译头（PCH）与C++20模块混用易引发定义冲突，尝试禁用PCH后重新构建。另外检查项目中是否存在重复编译单元，或同一头文件被多个模块/源文件以不同方式处理。

• 升级Clang到最新稳定版
  部分早期Clang 17版本存在模块处理的bug，确保使用的Clang版本为>=17的最新稳定版，避免版本兼容性问题。

附用户提供的CMakeLists.txt示例 #

# 示例CMakeLists.txt
cmake_minimum_required(VERSION 3.28)
project(HS.Debug)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(wxWidgets REQUIRED COMPONENTS core base)
include(${wxWidgets_USE_FILE})

add_executable(HS.Debug main.cpp)
target_link_libraries(HS.Debug ${wxWidgets_LIBRARIES})

# 模块相关配置
target_sources(HS.Debug
  PRIVATE
    main.cpp
  PUBLIC
    FILE_SET CXX_MODULES
    BASE_DIRS ${PROJECT_SOURCE_DIR}
    FILES
      mymodule.cppm
)

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