使用CMAKE_PREFIX_PATH在CMake中查找wxWidgets失败的问题排查与解决

我来帮你理清这个问题的根源，再给出具体的解决方案，同时告诉你官方文档里关于WXWIDGETS_ROOT_DIR的说明位置。

问题原因 #

你遇到的问题源于CMake自带的FindwxWidgets.cmake模块（也就是调用find_package(wxWidgets)时用到的查找模块）的特殊逻辑：它不会自动遍历CMAKE_PREFIX_PATH下的所有子目录去寻找wxWidgets，而是依赖特定标记变量（比如WXWIDGETS_ROOT_DIR）、系统默认安装路径或环境变量来定位库文件。

当你把CMAKE_PREFIX_PATH设为包含wxWidgets-3.1.4的上级目录时，这个模块并不会主动扫描该子目录，所以自然找不到对应的库文件。

可行的解决方案 #

这里有几种方式可以解决这个问题，你可以根据自己的习惯选择：

1. 直接将CMAKE_PREFIX_PATH指向wxWidgets根目录 #

不用指向上级目录，直接把CMAKE_PREFIX_PATH设置为wxWidgets-3.1.4的完整路径。比如在命令行执行CMake时：

cmake -DCMAKE_PREFIX_PATH=/path/to/wxWidgets-3.1.4 ..

或者在你的CMakeLists.txt开头（cmake_minimum_required之后）添加：

set(CMAKE_PREFIX_PATH "/path/to/wxWidgets-3.1.4" ${CMAKE_PREFIX_PATH})

这样FindwxWidgets模块就能在指定的根目录下找到它需要的配置文件（比如wx-config脚本或内部CMake配置）。

2. 继续使用WXWIDGETS_ROOT_DIR（已验证的可靠方式） #

你之前通过设置WXWIDGETS_ROOT_DIR环境变量的方式是完全合规的，这也是FindwxWidgets模块明确支持的方式。除了环境变量，你也可以直接在CMake命令行指定：

cmake -DWXWIDGETS_ROOT_DIR=/path/to/wxWidgets-3.1.4 ..

或者在CMakeLists.txt中设置变量：

set(WXWIDGETS_ROOT_DIR "/path/to/wxWidgets-3.1.4")

3. 自定义CMAKE_MODULE_PATH（特殊场景适用） #

如果你的wxWidgets安装目录下提供了自定义CMake模块文件（比如在wxWidgets-3.1.4/cmake目录下），可以把这个路径添加到CMAKE_MODULE_PATH，让CMake优先使用这里的模块：

set(CMAKE_MODULE_PATH "/path/to/wxWidgets-3.1.4/cmake" ${CMAKE_MODULE_PATH})

不过通常CMake自带的FindwxWidgets模块已经足够用，这个方法更多用于自定义编译的wxWidgets场景。

官方文档参考位置 #

关于WXWIDGETS_ROOT_DIR的官方说明，你可以在两个地方找到：

• CMake官方文档：搜索CMake官方文档中的FindwxWidgets模块，在「Input Variables（输入变量）」部分，会明确列出WXWIDGETS_ROOT_DIR，说明它是用于覆盖默认查找路径的变量，用来指定wxWidgets的安装根目录。
• wxWidgets官方文档：在wxWidgets官方文档的CMake集成章节中，也会说明如何通过CMake变量或环境变量来指定库的安装位置。

这些文档都正式提到了这个变量的作用，并非只有Stack Overflow帖子才会涉及。

最后要说明的是，你的现有CMakeLists.txt代码本身没有问题，只要正确设置了上述路径变量，find_package(wxWidgets REQUIRED COMPONENTS core base)就能正常工作，后续的链接和编译也不会有问题。

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