Windows下find_package默认找不到OpenCV等库，因CMake仅搜索固定路径且不自动扫描自定义安装目录；需通过set(OpenCV_DIR "path")或HINTS指定OpenCVConfig.cmake位置，并用CONFIG模式调用。
Windows 下 find_package 不是“用不用”的问题，而是“它默认根本找不到你装的库”——除非你明确告诉它去哪儿找，或者让库自己带好“路标”（Config 文件）。
为什么 find_package(OpenCV) 在 Windows 上总报错？
因为 CMake 默认只在几个固定位置找：CMake 自带的 Modules/ 目录、CMAKE_MODULE_PATH 里加的路径。它不会自动扫描 C:\Program Files\OpenCV 或你手动解压的 D:\deps\opencv。Linux/macOS 有 pkg-config 和标准路径兜底，Windows 没这待遇。
- 常见错误信息：
Could NOT find OpenCV (missing: OpenCV_DIR)—— 这不是说没装 OpenCV，是说 CMake 没找到OpenCVConfig.cmake - 如果你用 vcpkg 安装，它默认把 Config 文件放在
vcpkg\installed\x64-windows\share\opencv4\OpenCVConfig.cmake，但 CMake 不会自己钻进去 - 如果你用官网预编译包，解压后 Config 文件通常在
build\install\lib\cmake\opencv4\，同样需要你指路
find_package 的两种模式必须分清：Module vs Config
这是所有问题的源头。CMake 先尝试 Module 模式（找 FindOpenCV.cmake），失败后再 fallback 到 Config 模式（找 OpenCVConfig.cmake）。Windows 上推荐直接走 Config 模式，更可靠。
- Module 模式依赖 CMake 自带或你自定义的
Findxxx.cmake，容易版本过时、逻辑僵硬（比如硬编码vc142而你用的是 vc143） - Config 模式由库作者提供，包含真实构建信息（Debug/Release 库路径、依赖关系、target 导出），只要路径对，基本不翻车
- 强制走 Config 模式：加
CONFIG参数，find_package(OpenCV CONFIG REQUIRED)；加NO_MODULE效果一样
怎么让 Config 模式真正生效？关键就三步
核心是让 CMake 知道 xxxConfig.cmake 在哪。别指望环境变量或注册表——CMake 基本不看。
- 最稳妥：用
set(xxx_DIR "path/to/xxx/lib/cmake/xxx")，例如set(OpenCV_DIR "D:/deps/opencv/build/install/lib/cmake/opencv4")，然后调用find_package(OpenCV CONFIG REQUIRED) - 如果路径含空格或反斜杠，用正斜杠或双反斜杠，
"D:/vcpkg/installed/x64-windows/share/opencv4"比"C:\Program Files\..."更少出错 - 多个库共用同一安装根目录？可以用
HINTS或PATHS，例如find_package(yaml-cpp CONFIG REQUIRED HINTS "${CMAKE_CURRENT_LIST_DIR}/thirdparty") - 绝对不要用
NO_DEFAULT_PATH除非你清楚关掉了哪些路径——它会禁用CMAKE_PREFIX_PATH、环境变量等所有后备机制
容易被忽略的坑：大小写、路径层级、target 名称
Windows 文件系统不区分大小写，但 CMake 包名和 Config 文件名是区分的。一个字母错，就彻底失联。
-
find_package(OpenCV)对应的是OpenCVConfig.cmake，不是opencvconfig.cmake或opencv-config.cmake - Config 文件必须在
xxx/lib/cmake/xxx/或xxx/share/xxx/这类标准子目录下；如果它孤零零躺在D:\libs\OpenCVConfig.cmake，CMake 找不到 - 找到 Config 后，它会导出
OpenCV::opencv_core这样的 IMPORTED target，而不是靠OpenCV_LIBRARIES变量——现代写法应优先用target_link_libraries(myapp PRIVATE OpenCV::opencv_core) - Debug/Release 库混用？检查 Config 文件里是否设置了
OpenCV_LIBRARY_DEBUG和OpenCV_LIBRARY_RELEASE，否则链接时可能拉错opencv_world480d.lib和opencv_world480.lib
