Qt Creator链接OpenCV库的坑，你踩过几个？

Qt Creator链接OpenCV库的坑，你踩过几个？

在Qt Creator中链接OpenCV库，就像是在黑暗中找袜子——你以为找到了一对，结果穿上去一只大一只小。别担心，本文将带你走出这个“坑坑洼洼”的配置迷宫。

你可能会遇到这样的错误提示：“libpng warning: Application built with libpng-1.6.27 but running with 1.5.13” 或者 “Wrong JPEG library version: library is 62, caller expects 80”。这就好比你请了一个会做川菜的厨师，结果他却端上来一盘粤菜，显然是版本搞错了。

原因分析

这通常是由于OpenCV编译时使用的依赖库版本与系统中已有的版本不一致。OpenCV在编译时会自带一些依赖库，如libpng和libjpeg，如果这些库的版本与系统中已有的版本不同，就会出现这种“罗生门”事件。

解决方案

在CMake配置时明确指定系统中依赖库的路径：

cmake -D WITH_JPEG=ON -D JPEG_LIBRARY=/usr/lib/aarch64-linux-gnu/libjpeg.so.8 -D JPEG_INCLUDE_DIR=/usr/include/ -D WITH_PNG=ON -D PNG_LIBRARY=/usr/lib/aarch64-linux-gnu/libpng16.so.16 -D PNG_INCLUDE_DIR=/usr/include/ ..

有时候，你可能会在.pro文件中这样写：

INCLUDEPATH += D:\opencv\build\include
LIBS += -LD:\opencv\build\u0064\vc15\lib -lopencv_world410

但是，Qt Creator却一脸懵逼，表示找不到库文件。这就像你告诉朋友去某个餐厅吃饭，但给的地址是火星的坐标。

原因分析

路径配置错误是主要原因。此外，Windows环境下路径分隔符的使用也是一个常见陷阱。在Qt的.pro文件中，路径分隔符应该使用正斜杠（/）或者双反斜杠（\）。

解决方案

确保路径正确且使用正确的分隔符：

INCLUDEPATH += D:/opencv/build/include
LIBS += -LD:/opencv/build/x64/vc16/lib -lopencv_world490

你可能会发现，在Debug模式下运行得好好的程序，一到Release模式就报错，或者反过来。这就像是同一个人在不同场合表现得判若两人，让人摸不着头脑。

原因分析

这是因为Debug和Release模式下需要链接不同的库文件。Debug模式下通常需要链接带有“d”后缀的库文件，而Release模式下则不需要。

解决方案

在.pro文件中根据构建模式选择正确的库文件：

win32:CONFIG(release, debug|release): LIBS += -LD:/opencv/build/x64/vc16/lib -lopencv_world490
else:win32:CONFIG(debug, debug|release): LIBS += -LD:/opencv/build/x64/vc16/lib -lopencv_world490d

1. 手动配置优于图形界面：虽然Qt Creator提供了图形化界面来添加库，但手动编辑.pro文件往往更可靠，也更容易发现问题。

2. 注意路径转义：在.pro文件中，Windows路径的分隔符应该使用正斜杠（/）或双反斜杠（\）。

3. 环境变量不要忘：确保系统的PATH环境变量中包含了OpenCV的动态链接库路径，这样在运行时才能找到相应的DLL文件。

4. 版本兼容性：确保OpenCV的版本与你的Qt版本兼容，同时注意OpenCV的编译器版本（如MSVC 2019）要与你的项目一致。

5. 清理重建：有时候，缓存会导致一些奇怪的问题。如果配置修改后仍然有问题，尝试清理项目并重新构建。

通过以上这些“避坑指南”，相信你可以在Qt Creator中顺利链接OpenCV库，不再为这些“坑”所困扰。记住，编程就像找袜子，有时候需要一点耐心和细心，但最终总会找到匹配的一对。