解决编译OpenCV项目时出现的undefined reference to cv::xxxx错误

最新推荐文章于 2025-07-04 15:23:54 发布
最新推荐文章于 2025-07-04 15:23:54 发布
阅读量5.6w 收藏 35
点赞数 9
CC 4.0 BY-SA版权
分类专栏： 雷区历险记
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/wang7807564/article/details/78416809

0x00 问题描述

使用OpenCV做一个人脸识别的C++程序，OpenCV已经编译好了，include与lib都存放在：

/usr/local/  目录中

在IDE中也可以引入openCV相关的头文件，并没有报异常，但是在编译的时候，就会出现错误：

各种头文件找不到，xxx函数没有定义之类的问题

0x01 问题分析

这其实是在编译的时候，编译的参数配置不正确，并没有指定Lib目录的路径，导致编译的时候，静态链接库无法找到

0x02 问题解决

既然是这个愿意，添加上依赖自然就可以编译了，直接使用g++的命令：

g++ main.cpp -o test `pkg-config --cflags --libs opencv`

这里面打pkg-config工具需要我们安装好，如果没有安装，使用yum 或者apt-get进行安装即可，你可以在Linux的shell中输入：

pkg-config来查看一下，你可以看到Lib的绝对路径

当然，是这个原因的话，你也可以在IDE中去配置好Lib目录


使用OpenCV库加载图像时出现undefined reference错误的解决方法
TechPr的博客
08-21 1925
然而，有时你可能会遇到类似这样的错误信息：《undefined reference to cv::imread(std::__cxx11::basic_string, std::char_traits, std》。通过按照上述步骤检查和更正编译选项，并根据你的需求修改示例代码，你应该能够成功加载和显示图像，而不再遇到undefined reference错误。首先，确保已经正确地安装了OpenCV库，并且可以在编译器中找到相应的头文件和库文件。在上面的代码中，首先包含了OpenCV的头文件。
解决Qt6 OpenCV项目编译出现错误undefined reference to symbol ‘cv::cvtColor，无法解析的符号
xcksj666的博客
07-17 389
在一次Qt6 OpenCV项目编译的过程中，出现错误undefined reference to symbol 'cv::cvtColor，无法解析的符号，问题是查看INCLUDEPATH和LIBS，都已经添加正确。在项目的生成目录下，这里我指定的DESTDIR为项目目录下的bin目录。将OpenCV bin目录下的dll文件都给搬过来，然后再运行Ctrl+R，这个错误消失。而且这个函数也可以在头文件中索引到。接着就可以继续构建运行了。
ros编译错误集合：opencv版本冲突 ‘resize‘ is not a member of ‘cv:: undefined Reference to ‘cv::..
qq_43056684的博客
08-01 2157
catkin_make错误类型： error:‘split’ is not a member of ‘cv::cuda’… error:‘resize’ is not a member of ‘cv::cuda’… … recipe for target ‘all’ faild Incvking “make -j6 -l6” faild … 这里可以通过添加对应的cv头文件解决error，比如 #include <opencv2/cudaimgproc.hpp> #include "openc
OpenCV中超分辨率（Super Resolution）模块类cv::dnn_superres::DnnSuperResImpl
最新发布
jndingxin的专栏
07-04 492
OpenCV中超分辨率（Super Resolution）模块的一个内部实现类。它属于dnn_superres模块，用于加载和运行基于深度学习的图像超分辨率模型。
关于QT下配置OpenCV3.4.0后出现 error: undefined reference to 'cv::xxx'的问题及解决方案
HerofH_的博客
10-12 1万+
由于之前在CodeBlocks，VS下配置并使用过OpenCV，原本以为在QT下配置OpenCV也很容易，结果事与愿违。按照网上的办法，在QT中pro文件末尾添加以下代码来引入OpenCV的库和头文件： INCLUDEPATH += D:\OpenCV3.4\opencv\build_mingw\install\x64\mingw\include LIBS += D:\OpenCV3....
OpenCV 编译错误 ‘未定义的引用’
huojh1的博客
10-05 1万+
OpenCV 编译错误 ‘未定义的引用’opencv安装完成也有一阵子了，我才用的是编译安装，环境Ubuntu16.04 LTS。今天有时间想自己写一点程序，却发现编译不过代码如下，打开命令行中输入的文件名并展示在窗口中// openpicture.cpp #include "opencv2/highgui/highgui.hpp"int main(int argc, char** argv) {
OpenCV : undefined reference to cv::imread()
Sunshine_in_Moon的专栏
12-09 1万+
最近在编译一个小工程时遇到了一个OpenCV的问题，如标题所示找不到函数接口。其实，我们一般遇到“undefined reference to”的错误首先想到的肯定是相关的库没有正确连接。但是我遇到的问题要比这个奇怪的多。 下面记录下我的解决思路，做个笔记防止后面在遇到相同的问题。 检查库是否正确连接 ldd ****.so可检查某个库的依赖情况，重点看那些找不到的库。如果我们发现某个库找不到，...
Ubuntu20.04下vscode编译opencv可执行文件时报错：undefined reference to `cv::Mat::Mat，如何解决？
**My Coding Family**
04-16 997
🏆本文收录于《全栈Bug调优(实战版)》专栏，主要记录项目实战过程中所遇到的Bug或因后果及提供真实有效的解决方案，希望能够助你一臂之力，帮你早日登顶实现财富自由🚀；同时，欢迎大家关注&&收藏&&订阅！持续更新中，up！up！up！！ 备注：部分问题/疑难杂症搜集于互联网。
【QT报错opencv的undefined reference to `cv::VideoCapture::VideoCapture()‘，fatal error: opencv2/dnn/dnn.】
weixin_47869094的博客
08-02 822
ubuntu下找不到VideoCapture类，原因是没有将libopencv_videoio.so连接进来，对于 VideoCapture 类，至少需要链接到 opencv_core、opencv_imgproc 和 opencv_videoio 库。#include这个错误提示是因为找不到OpenCV的dnn模块，可以尝试安装OpenCV并重新编译代码。在make的时候报错opencv2/dnn/dnn.hpp:没有那个文件或目录。1.安装OpenCV。
main.cpp:(.text+0x1180): undefined reference to `cv::randn(cv::_InputOutputArray const&, cv::_InputA
01-09
在开发C++项目时，尤其是涉及OpenCV库的项目，经常遇到链接错误，如"undefined reference"。这类问题通常是因为编译器在链接阶段找不到所需的库函数定义。在这个特定的例子中，开发者在尝试运行一个包含KalmanFilter...
Ubuntu编译opencv3.4.5报错undefined reference to `cv::cuda::SURF_CUDA::SURF_CUDA()及解决方案
weixin_51127762的博客
07-04 2045
Ubuntu18.04编译opencv3.4.5报错undefined reference to `cv::cuda::SURF_CUDA::SURF_CUDA()及解决方案
OpenCV undefined reference to `cvUpdateMotionHistory'
aiqinchao的专栏
05-25 868
找不到 cvUpdateMotionHistory函数 我使用的是ubuntu 16.04，装有ROS系统，在cmake时发现，寻找的是ROS中OpenCV库3.3.1， 所以，我打开CMakeCache.make文件，发现下面一句。 因此，可能在生成make文件时，没有指定OpenCV版本导致的。所以，打开CMakeLists.txt文件。 vim CMakeLists.txt 指定Op...
【debug】OpenCV出现问题：undefined reference to ‘cv::Mat::Mat()‘
qq_45461410的博客
08-04 1万+
解决OpenCV出现问题：undefined reference to 'cv::Mat::Mat()'
解决ROS编译安装Opencv项目出现undefined Reference to....问题
蒋程扬的部落格
07-10 8219
一，问题描述 已经编译安装了Opencv,但是编译Opencv功能包时出现undefined Reference to…的错误 二，解决方法 这一般是由于多个Opencv环境冲突的问题，比如我这里编译安装Opencv3.3.1版本 则需要通过以下命令安装： unzip opencv-3.3.1.zip cd opencv-3.3.1 mkdir build cd build cmake -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=/usr/loc
有关Opencv Undefined Reference to cv::Mat::updateContinuityFlag()编译问题的解决
热门推荐
Reginasong的博客
04-21 2万+
VScode编译中opencv的undefined reference 问题 一般来说，undefined reference to cv:: 等的问题是关于编译时依赖文件的问题，应该将包含库的路径弄好了就没问题（至少我是这样，而且网上对于具体问题应该有更具体的解决方法的文章，这个文章主要是针对Undefined Reference to cv::Mat::updateContinuityFlag...
ubuntu12.04 安装opencv
愤怒的小鸡
11-10 1120
原文转自http://www.cnblogs.com/pswzone/archive/2012/10/20/2732791.html 1 编译环境 sudo apt-get install build-essential 2 安装GTK环境  sudo apt-get install libgtk2.0-dev   3 编译GTK程序时自动找出头文件及库文件位置  sudo apt-
调用OpenCV库出现: undefined reference to `xxxxx‘ 的解决办法（使用MinGW编译器）
qq_38043069的博客
06-16 1万+
调用OpenCV库出现：undefined reference to "XXXX"错误的解决办法
C++ 调用opencv失败 undefined reference to `cv::VideoCapture::VideoCapture(cv::String const&)'
.
09-30 7386
环境： jetsonTX2  ubuntu18.04  opencv3.4 问题： 用C++调用Jetson TX2 上的板载摄像头  参考：https://blog.youkuaiyun.com/zong596568821xp/article/details/80314336 但是g++ 编译失败 解决方案： 1.必须把系统自带的opencv卸载后，再重新安装opencv3.4 2.命令不要输...
QT5在windows下调用OpenCV库出现: undefined reference to `xxxxx‘ 错误解决办法（适用MinGW编译器）。
我不是码农的博客~~~
04-21 5371
一、环境介绍 window系统：win10 X64 QT版本: 5.12 QT5.12自带的MinGW编译器版本：mingw730_32 与mingw730_64 在QT的安装目录下，可以查看MinGW编译器的版本: 二、使用OpenCV出现的问题 在QT框架代码里使用老版本的分类器(cvLoad、cvHaarDetectObjects)处理图像时，正常编译没有问题，当使用新版本级联分类器(CascadeClassifier)时，程序编译就会出现一堆没有定义的错误： release/widget.o:wid
undefined reference to cv::
04-03
<think>好的，我现在需要帮助用户解决“undefined reference to cv::”的错误。首先，我应该先理解这个错误的含义。用户在使用OpenCV库时，编译链接阶段出现了未定义的引用错误，通常是因为编译器找不到对应的函数或类的实现。 接下来，我需要回忆常见的导致这种错误的原因。首先想到的是OpenCV库没有正确链接。可能用户没有在编译命令中添加必要的链接选项，比如`-lopencv_core`或者`-lopencv_imgproc`等。另外，用户可能安装了OpenCV但没有指定正确的库路径，导致编译器找不到库文件。 然后，我需要考虑用户可能的环境问题。比如，用户是否安装了多个版本的OpenCV，导致链接到了错误的版本。或者用户可能使用了CMake，但CMakeLists.txt中没有正确配置find_package(OpenCV)或者target_link_libraries。 接着，我需要思考如何分步骤帮助用户排查问题。第一步应该是检查编译命令是否正确，是否包含了所有必要的OpenCV模块。第二步是确认OpenCV的安装路径是否正确，是否在编译时通过`-I`和`-L`指定了头文件和库路径。第三步是检查库文件是否存在，是否有权限问题。第四步可能是检查代码中是否存在拼写错误或者版本不兼容的问题，比如使用了新版本的OpenCV但代码调用了旧版本的API。 用户可能的另一个问题是使用了pkg-config工具，但没有正确生成链接参数。这时候需要提醒用户使用`pkg-config --cflags --libs opencv4`来获取正确的编译选项。 另外，用户可能没有正确安装OpenCV的开发包，比如在Ubuntu上可能只安装了运行时库而没有安装libopencv-dev。这时候需要建议用户安装对应的开发包。 还需要考虑用户是否在代码中正确包含了头文件，比如#include <opencv2/core.hpp>，如果头文件缺失，也可能导致链接错误，但通常会先出现编译错误而不是链接错误。 最后，我应该总结常见的解决方案，按照从简单到复杂的顺序排列，帮助用户一步步排查问题，确保他们能够找到问题所在并解决。</think>以下是对“undefined reference to cv::”错误的详细分析及解决方案： ==================== 一、错误本质说明 ==================== 该错误属于**链接阶段错误**，表示编译器能找到OpenCV头文件，但链接器无法找到对应的库实现。典型报错形式： ```bash undefined reference to `cv::imread(cv::String const&, int)' ``` ==================== 二、核心原因分析 ==================== 1. **库链接缺失**：编译命令未指定必需的OpenCV库 2. **ABI版本冲突**：C++编译器标准与OpenCV编译版本不匹配 3. **安装不完整**：缺少开发包（如未安装`libopencv-dev`） 4. **路径配置错误**：头文件与库文件路径未正确指定 ==================== 三、系统化解决方案 ==================== **步骤1：验证基础编译命令** ```bash # 标准编译命令模板（需根据实际情况调整路径） g++ main.cpp -o app \ -I/usr/include/opencv4 \ -L/usr/lib/x86_64-linux-gnu \ -lopencv_core -lopencv_imgcodecs -lopencv_highgui ``` **步骤2：检查OpenCV安装完整性**（Ubuntu示例） ```bash # 确认开发包已安装 dpkg -l | grep libopencv-dev # 验证关键库文件存在性 ls /usr/lib/x86_64-linux-gnu/libopencv_core.so ``` **步骤3：使用pkg-config自动化配置**（推荐） ```bash # 安装pkg-config工具 sudo apt install pkg-config # 获取正确的编译参数 g++ main.cpp -o app $(pkg-config --cflags --libs opencv4) ``` **步骤4：排查版本冲突问题** ```markdown 1. 确认编译器标准与OpenCV编译标准一致（C++11/14/17） 2. 检查多版本OpenCV共存情况： ```bash sudo updatedb && locate libopencv_core.so ``` 3. 显式指定库版本： ```bash -lopencv_core.so.4.5 ``` ==================== 四、CMake工程专用配置 ==================== **正确CMakeLists.txt配置示例**： ```cmake cmake_minimum_required(VERSION 3.10) project(OpenCV_Project) find_package(OpenCV REQUIRED COMPONENTS core imgcodecs highgui) add_executable(app main.cpp) target_link_libraries(app ${OpenCV_LIBS}) ``` **关键验证命令**： ```bash # 查看OpenCV被查找的路径 cmake -DCMAKE_PREFIX_PATH=/usr/local/opencv4 .. ``` ==================== 五、进阶诊断方法 ==================== 1. **符号表检查**： ```bash nm -D /usr/lib/libopencv_core.so | grep cv::imread ``` 2. **编译日志分析**： ```bash g++ -v main.cpp 2>&1 | grep -i opencv ``` 3. **环境变量覆盖检测**： ```bash echo $LD_LIBRARY_PATH echo $PKG_CONFIG_PATH ``` ==================== 六、典型错误场景 ==================== **场景1：仅包含头文件未链接库** ```cpp #include <opencv2/opencv.hpp> // 正确包含 int main() { cv::Mat img = cv::imread("test.jpg"); // 链接阶段报错 } ``` **解决方案**：必须添加`-lopencv_imgcodecs` **场景2：ABI版本不匹配** ```cpp // 使用C++17编译但OpenCV使用C++11编译 ``` **解决方案**：统一使用相同C++标准重新编译 ==================== 七、平台特异性问题 ==================== | 平台 | 常见问题 | 解决方案 | |------------|--------------------------|----------------------------| | Windows | vcpkg路径配置错误 | 设置`CMAKE_TOOLCHAIN_FILE` | | macOS | Homebrew安装路径差异 | 使用`/opt/homebrew`路径 | | Ubuntu | 多版本冲突 | `update-alternatives`配置 | | 嵌入式系统 | 交叉编译链配置错误 | 检查`arm-linux-gnueabi`配置| 建议优先使用OpenCV官方文档验证开发环境配置：https://docs.opencv.org/
评论 10
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值