CLion中Cygwin环境编译OpenCV项目报未定义引用错误求助

这是OpenCV项目典型的链接阶段配置缺失问题，核心诱因如下：

• 你的CMakeLists.txt仅执行了OpenCV包查找逻辑，没有将找到的OpenCV库文件链接到生成的可执行程序上，链接器找不到OpenCV核心类、函数的实现地址，因此抛出undefined reference系列报错。
• 额外兼容风险：Cygwin环境下如果混装了Windows原生VC编译的OpenCV版本，会出现ABI不兼容问题，也会触发同类报错，只要你是通过Cygwin官方setup程序安装的libopencv-devel及相关依赖包就不存在该问题。
• 次要冗余问题：测试代码中重复包含了两次opencv2/opencv.hpp头文件，不影响编译但属于无意义写法。

1. 修正CMakeLists.txt配置 #

补全目标链接逻辑，同时规避C++标准兼容问题，修改后完整配置如下：

cmake_minimum_required(VERSION 3.20)
project(imageprocessing)

# Cygwin下GCC 11对C++23的支持为实验性版本，易触发兼容问题，建议先用C++17排查问题
set(CMAKE_CXX_STANDARD 17)

# 查找OpenCV包
find_package(OpenCV REQUIRED)
# 声明可执行目标
add_executable(imageprocessing main.cpp)

# 关键配置：绑定OpenCV头文件路径、链接OpenCV库到目标
target_include_directories(imageprocessing PRIVATE ${OpenCV_INCLUDE_DIRS})
target_link_libraries(imageprocessing PRIVATE ${OpenCV_LIBS})

注意：target_link_libraries和target_include_directories必须写在add_executable声明目标之后，否则CMake会抛出找不到目标的错误。

2. 简化测试代码 #

删除重复的头文件包含，修正后代码如下：

#include <iostream>
#include <opencv2/opencv.hpp>
using namespace cv;
using namespace std;

int main() {
    Mat image;
    cout << "Hello, World!" << endl;
    return 0;
}

3. 重新构建项目 #

先删除CLion中项目原有的cmake-build-*构建缓存目录，重新加载CMake配置后再执行编译即可。
如果修正配置后仍报错，可打开Cygwin终端执行pkg-config --libs opencv4（OpenCV4版本）或pkg-config --libs opencv（OpenCV3版本）检查库查询结果，如果返回为空说明OpenCV开发包未安装完整，重新运行Cygwin setup程序安装全量libopencv开头的开发包即可。

内容的提问来源于stack exchange，提问作者Zaeem Asghar