find_package 指定路径仍失败，因 paths/hints 仅为提示而非强制路径，需确保路径为安装根目录、文件名大小写严格匹配、手动设置 cmake_module_path 或 wxwidgets_root_dir 等关键变量。
find_package 指定目录但 still not found？先确认它真在找你给的路径
CMake 的 find_package 默认不接受“直接指定路径”参数——你传的 PATHS 或 HINTS 只是提示，不是强制路径。它仍会按 Module 模式或 Config 模式完整走一遍查找逻辑，最后才 fallback 到你给的路径。
常见错觉是写了 find_package(OpenCV REQUIRED PATHS /opt/opencv) 就以为 CMake 会去 /opt/opencv 下翻 OpenCVConfig.cmake，其实它只会在 /opt/opencv/lib/cmake/OpenCV/、/opt/opencv/share/OpenCV/ 这类子目录里找，而且必须匹配标准结构。
- 确保你给的
PATHS是安装根目录（比如/usr/local），不是include/或lib/子目录 -
HINTS比PATHS优先级高，但依然不跳过默认路径扫描；想跳过默认路径，得加NO_DEFAULT_PATH - 用
message(STATUS "CMAKE_PREFIX_PATH = ${CMAKE_PREFIX_PATH}")看当前生效的搜索前缀，避免被环境变量干扰
FindXXX.cmake 文件根本不在 CMAKE_MODULE_PATH 里？手动加进去
Module 模式下，CMake 只查 CMAKE_MODULE_PATH 和自身 Modules/ 目录。如果你自己写了 FindwxWidgets.cmake，但没告诉 CMake 去哪找，它永远看不到。
正确做法是在 CMakeLists.txt 最开头（project() 之前）设置：
set(CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake/modules" ${CMAKE_MODULE_PATH})
然后把你的 FindwxWidgets.cmake 放进 cmake/modules/ 目录即可。
- 不要用相对路径如
./cmake/modules—— CMake 在 out-of-source 构建时会找不到 - 如果多个项目共用一套 Find 模块，建议统一放在某个
share/cmake/Modules目录，并用-DCMAKE_MODULE_PATH=/path/to/share/cmake/Modules传入 - Windows 上注意路径分隔符：用正斜杠
/或双反斜杠\，单反斜杠会被当转义符处理
Config 模式下 OpenCVConfig.cmake 找不到？大小写和文件名必须完全匹配
Config 模式不看大小写敏感性，但严格匹配文件名。写 find_package(Opencv REQUIRED) 就会找 OpencvConfig.cmake，而 OpenCV 官方只提供 OpenCVConfig.cmake 或 opencv-config.cmake —— 少一个字母或错一个大小写都失败。
典型错误链：find_package(OpenCV REQUIRED) → 找 OpenCVConfig.cmake → 成功；find_package(opencv REQUIRED) → 找 opencvConfig.cmake → 失败（不存在）。
- Linux/macOS 下文件系统区分大小写，
OpenCVConfig.cmake和opencvconfig.cmake是两个文件 - 检查目标目录是否存在该文件：
ls -l /path/to/opencv/lib/cmake/OpenCV/OpenCVConfig.cmake - 若只有
opencv-config.cmake（小写+连字符），就用find_package(opencv CONFIG REQUIRED)，并确保路径在CMAKE_PREFIX_PATH中
Windows 下 wxWidgets 找不到？别信注册表，老老实实设变量
Windows 上很多库（比如 wxWidgets）依赖注册表或环境变量，但 CMake 的 find_package 很少主动读取这些。更可靠的方式是绕过自动查找，手动指定关键路径：
set(wxWidgets_ROOT_DIR "C:/wxWidgets-3.2.1")<br>set(wxWidgets_LIB_DIR "${wxWidgets_ROOT_DIR}/lib/vc143_x64_lib")<br>find_package(wxWidgets REQUIRED COMPONENTS core base adv)
这样 CMake 就不会再去注册表或默认路径瞎撞。
-
wxWidgets_ROOT_DIR是多数 Find 模块识别的“权威根目录”，设了它，其他路径常能自动推导 - Debug/Release 库命名不一致（如
wxmsw32ud_core.libvswxmsw32u_core.lib）会导致 COMPONENTS 匹配失败，可加DEBUG_LIBRARY_SUFFIX "d"控制后缀 - 如果
find_package报missing: wxWidgets_INCLUDE_DIRS，说明头文件路径没推导出来，直接补上：set(wxWidgets_INCLUDE_DIRS "${wxWidgets_ROOT_DIR}/include")
最麻烦的不是找不到文件，而是 CMake 找到了错误的版本——比如系统自带的旧版 OpenCV 覆盖了你编译的新版。检查 find_package 输出里的 Found XXX at ... 路径，别让它悄悄用了别的安装树。
