Windows下使用CMake构建依赖wxWidgets的项目失败求助

问题场景 #

在Windows系统使用CMake构建依赖wxWidgets的GitHub项目时，遵循官方指南操作后遇到以下问题：

• 初始使用find_package无法定位wxWidgets
• 手动指定wxWidgets_DIR后，CMake报错wx::wxbase引用的C:/Program Files (x86)/lib/vc_x64_dll/wxbase32ud.lib不存在
• 将项目CMakeLists.txt修改为与minimal示例一致后，仍提示安装包缺失配置文件引用的文件

解决方法 #

1. 验证wxWidgets安装/编译的路径与架构匹配 #

• 检查C:/Program Files (x86)/wxWidgets/lib/vc_x64_dll目录是否存在，且wxbase32ud.lib文件确实在该目录中。若使用官方预编译包，需确认下载的是x64架构的VC DLL版本，避免x86与x64版本混淆。
• 若自行编译wxWidgets，确保编译时的目标架构（x64）与CMake Configure阶段选择的编译器架构（如Visual Studio的x64平台）完全一致。

2. 修正CMake路径配置方式 #

• 避免硬编码wxWidgets_DIR，改用CMake GUI添加wxWidgets_ROOT_DIR变量，值设为wxWidgets根目录（如C:/Program Files (x86)/wxWidgets），让CMake自动检索正确的配置文件。
• 确保CMake构建类型与wxWidgets编译版本匹配：Debug构建对应wxWidgets的Debug DLL版本，Release构建对应Release版本。示例CMake代码：

  set(CMAKE_BUILD_TYPE Debug) # 根据实际版本切换为Release
  find_package(wxWidgets REQUIRED core base CONFIG)
  include(UsewxWidgets)
  

3. 重新生成wxWidgets的CMake配置文件（自行编译场景） #

若为自行编译的wxWidgets，重新编译时指定明确的安装路径，避免相对路径错误：

cmake -S . -B build -DCMAKE_INSTALL_PREFIX="C:/wxWidgets-install" -DwxBUILD_SHARED=ON -DwxBUILD_VENDOR=custom
cmake --build build --target install

之后在项目中设置wxWidgets_DIR为C:/wxWidgets-install/lib/cmake/wxWidgets。

4. 检查预编译包完整性 #

若使用官方预编译包，重新下载对应架构的完整包并解压，确保解压路径无中文、空格或特殊字符，防止CMake解析路径失败。

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