编译成功但运行时报“找不到opencv_worldxxx.dll”是因为Windows加载器在运行时无法定位DLL，根本原因是PATH未生效或DLL路径不唯一；需确保调试环境PATH正确配置、避免多版本DLL冲突，并用Dependencies工具验证实际加载路径。
为什么编译成功但运行时报“找不到 opencv_worldxxx.dll”
这不是编译器的问题，而是 Windows 加载器在启动可执行文件时查不到动态库——opencv_world490.dll（或带 d 后缀的调试版）根本没被加载到内存里。常见现象是：Ctrl+Shift+B 构建通过、g++ 无报错、但双击 exe 或 F5 调试时弹窗报错，甚至控制台输出 The program can't start because opencv_world490.dll is missing。
根本原因只有两个：PATH 没生效 或 DLL 路径不唯一。VSCode 的调试器（GDB / Windows 默认调试器）不会继承你终端里手动设置的 PATH，它只认 launch.json 里 env.PATH 的值；同时，如果项目目录、build 目录、MinGW bin 目录下都混着不同版本的 libstdc++-6.dll 或 opencv_world*.dll，Windows 会按路径顺序加载第一个，其余静默忽略。
- 用
Dependencies（免费开源工具）打开你的.exe，右键每个 DLL → “Open containing folder”，确认它实际从哪加载 -
launch.json中必须写死 MinGW 的bin路径，例如："env": {"PATH": "C:\mingw64\bin;${env:PATH}"}（注意双反斜杠） - 别把 DLL 拷到
exe同目录“临时救火”——这会掩盖环境配置问题，且多个库依赖不同 ABI 版本时必然冲突
c_cpp_properties.json 和 tasks.json 的 includePath 必须严格对齐
c_cpp_properties.json 只管编辑器提示，tasks.json 才决定真实编译行为。两者路径不一致，就会出现“头文件能跳转但编译报 fatal error: opencv2/opencv.hpp: No such file or directory”。
关键点在于：includePath 填的是头文件**父目录**，不是完整路径。比如 OpenCV 预编译包解压在 C:opencv，头文件实际在 C:opencvuildinclude 和 C:opencvuildincludeopencv2，那么 includePath 应该加 C:opencvuildinclude，而不是 C:opencvuildincludeopencv2；否则 #include <opencv2/opencv.hpp> 会标红。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
-
compilerPath必须指向你真实使用的g++.exe（如C:\mingw64\bin\g++.exe），不能是clang++.exe或空路径——IntelliSense 会按错误 ABI 解析宏定义，导致cv::Mat提示异常 -
tasks.json的args中必须显式加-I参数，且路径与c_cpp_properties.json一致，例如："-IC:\opencv\build\include" - Linux/macOS 下用
pkg-config --cflags opencv4获取准确路径，通常为/usr/local/include/opencv4，别漏掉系统标准头路径（如/usr/include/c++/13）
tasks.json 里 -L 和 -l 参数怎么写才不报 undefined reference
undefined reference to cv::imread 这类链接错误，99% 是 tasks.json 没告诉 g++ 去哪找库文件、或链接顺序错了。OpenCV 的 .a 文件（MinGW）或 .lib（MSVC）必须被 -L 指向，并用 -l 显式链接，不能靠 includePath 自动推导。
-
-L后跟的是.a文件所在目录，不是头文件目录。MinGW 编译的 OpenCV 库通常在C:\opencv\build\install\lib或C:\opencv\build\lib，里面是libopencv_core.a、libopencv_imgproc.a等 -
-lopencv_core -lopencv_imgproc -lopencv_highgui的顺序有依赖关系：被依赖的库要放在后面。常用顺序是highgui → imgproc → core，或者直接用-lopencv_world（前提是编译时启用了BUILD_opencv_world） - MinGW 下不要混用
.lib（VC 版本）和.a（GCC 版本）——前者会导致链接失败，后者名通常是libopencv_world490.a，对应 DLL 名为opencv_world490.dll
MinGW 和 MSVC 工具链绝对不能混用
OpenCV 预编译包分 MinGW 版和 VC 版，二者 ABI 不兼容。用 MinGW 编译的代码，必须配 MinGW 编译的 OpenCV；用 cl.exe 编译的代码，必须配 VC 版 OpenCV。混用会导致 cv::Mat 构造崩溃、cv::imread 返回空 cv::Mat、甚至调试器直接退出。
- 检查 OpenCV 安装包名字：含
vc14/vc15/vc17的是 VC 版，含mingw或没标注的通常是 MinGW 版（下载页会注明） - 验证
compilerPath：运行g++ -v输出的配置路径，必须和c_cpp_properties.json里写的完全一致 - 检查库文件后缀：
libopencv_core.a是 MinGW，opencv_core490.lib是 VC；DLL 名若带d（如opencv_world490d.dll）是 Debug 版，Release 版无d
最易被忽略的一点：CMake Tools 插件生成的 tasks.json 可能默认继承了旧配置，哪怕你删了 c_cpp_properties.json，IntelliSense 引擎也不会自动刷新——改完配置后务必按 Ctrl+Shift+P → “C/C++: Restart IntelliSense Engine”。
