cmake-gui中正确设置opencv路径需指定opencv_dir为含opencvconfig.cmake的目录，如预编译版填c:/opencv/build/x64/vc17/lib，mingw版填c:/opencv/build/mingw64-build/install/lib/cmake/opencv4，而非include或bin目录。
cmake-gui 里怎么填 OpenCV 路径才不报错
直接用 find_package(OpenCV REQUIRED) 找不到库，根本原因是 CMake 不知道 OpenCV 在哪——它不会自动扫描系统路径。必须手动告诉它头文件和库在哪，或者提前设好 CMAKE_PREFIX_PATH。
常见错误现象：Could NOT find OpenCV (missing: OpenCV_DIR) 或 find_package failed: No module named 'opencv'（Python 情况下）。
- 如果用了预编译版（比如
opencv-4.8.1-windows.exe解压到C:\opencv），在 cmake-gui 里点Configure后，手动添加变量：OpenCV_DIR→ 值设为C:/opencv/build/x64/vc17/lib（注意：不是bin或include，是含OpenCVConfig.cmake的那个lib目录） - 如果用的是 MinGW 编译的版本，
OpenCV_DIR应指向C:/opencv/build/mingw64-build/install/lib/cmake/opencv4（路径末尾带opencv4是 OpenCV 4.x 的固定子目录） - 别填
OPENCV_INCLUDE_DIRS或OPENCV_LIBS这类老式变量——CMake 3.10+ 推荐走find_package+OpenCV_DIR，否则容易漏模块或链接顺序错
cmake -G 怎么选生成器才匹配你的编译器
生成器选错，轻则 Cannot open include file: 'opencv2/opencv.hpp'，重则根本生成不了项目文件。
关键看你在用什么工具链：
- 用 Visual Studio 2022？命令行运行：
cmake -G "Visual Studio 17 2022" -A x64 ..（-A x64强制 64 位，避免默认生成 Win32 平台） - 用 MinGW-w64（比如
gcc.exe在D:\mingw64\bin）？必须用：cmake -G "MinGW Makefiles" ..，且确保gcc --version和mingw32-make --version都能正常执行 - 用 MSVC 但想生成 Ninja 构建文件？先装 Ninja，再用：
cmake -G Ninja ..，比 VS 生成器快，但调试时不能直接双击 .vcxproj
注意：cmake-gui 界面里选生成器时，“Visual Studio 17 2022” 和 “MinGW Makefiles” 是互斥选项，切勿混用——VS 生成器不认 gcc，MinGW 生成器也不调用 cl.exe。
CMakeLists.txt 里 target_link_libraries 怎么写才不漏模块
只写 ${OpenCV_LIBS} 看似省事，但实际会漏掉 opencv_world 或扩展模块（如 opencv_dnn），尤其当你用了 cv::dnn::readNetFromONNX() 却没链接 dnn 时，链接阶段报 undefined reference to `cv::dnn::readNetFromONNX'。
- 安全写法是显式列出所需模块：
target_link_libraries(demo opencv_core opencv_imgproc opencv_highgui opencv_dnn) - 如果用了
opencv_world（预编译包里常见），就只写一个：target_link_libraries(demo opencv_world481)（后缀数字必须和你安装的版本一致，如 4.8.1 →481） - 千万别写
opencv_core481.lib这种带扩展名的——CMake 会自动补.lib或.a，硬写反而跨平台失效
为什么 dll 找不到，PATH 加了还是报错
编译通过、链接成功，但运行时报 The code execution cannot proceed because opencv_core481.dll was not found，问题不在 CMake，而在 Windows 动态加载机制。
- 最稳方案：把
C:\opencv\build\x64\vc17\bin（或 MinGW 版的install/bin）加进系统PATH，然后**重启终端或 VS Code**——环境变量改了不重启终端，进程看不到新 PATH - 快速验证法：不改 PATH，直接把所有
opencv_*.dll复制到你的demo.exe同目录下，能跑通说明路径配置本身没问题 - MinGW 用户特别注意：
libopencv_core.a是静态库，但默认链接的是动态版；如果想静态链接，得加-DWITH_PTHREADS_PF=OFF -DBUILD_SHARED_LIBS=OFF重新编译 OpenCV，否则光改 CMakeLists 无效
真正容易被忽略的是：Visual Studio 默认生成 Debug 版可执行文件，但它会去找 opencv_world481d.dll（带 d 后缀），而预编译包通常只提供 Release 版 dll。要么编译时切到 Release 模式，要么自己编译带 d 的 debug 版 OpenCV。
