Cygwin环境下链接器找不到cv::VideoCapture构造函数的问题求助

问题背景 #

在Cygwin环境下使用OpenCV 3.4.1编写视频读取程序时，编译过程无报错，但链接阶段失败——链接器无法找到cv::VideoCapture::VideoCapture(std::string const&, int)的定义。尽管通过符号验证确认库中存在cv::String参数的对应构造函数，尝试转换参数类型、显式指定API模型等操作均未解决问题。

源代码 #

#include <iostream>
#include <filesystem>
#include <opencv2/opencv.hpp>

using namespace std;

int main(int argc, char *argv[])
{
    if (!filesystem::exists(argv[1])) {
        cerr << "Video file not found: " << argv[1] << "\n";
        return 1;
    }

    cv::VideoCapture cap(argv[1]);
    if (cap.isOpened()) {
        cap.release();
        cout << "OK!\n";
    } else {
        cerr << argv[1] << ": can't open video for reading\n";
    }
}

编译与链接情况 #

编译命令（执行后无报错）：

$ g++ -c -g opencvread.cpp -o opencvread.o

链接错误输出：

$ g++ -g  -L/usr/lib    opencvread.o  -lopencv_videoio -o opencvread

/usr/lib/gcc/x86_64-pc-cygwin/13/../../../../x86_64-pc-cygwin/bin/ld: opencvread.o: in function `main':
/cygdrive/c/Users/xtolchinskii/src/exsta/test/opencvread.c++:16:(.text+0xdd): undefined reference to `cv::VideoCapture::VideoCapture(std::string const&, int)'
collect2: error: ld returned 1 exit status

库文件验证结果 #

查看系统中OpenCV视频相关库：

$ ls -1 /usr/lib/libopencv*video*.a
/usr/lib/libopencv_video.dll.a
/usr/lib/libopencv_videoio.dll.a
/usr/lib/libopencv_videostab.dll.a

检查库中的目标符号：

$ nm -CA /usr/lib/libopencv*.a | grep -i 'videocapture(.*string.*,.*int.*)'
/usr/lib/libopencv_videoio.dll.a:d000117.o:0000000000000000 T cv::VideoCapture::VideoCapture(cv::String const&, int)
/usr/lib/libopencv_videoio.dll.a:d000113.o:0000000000000000 T cv::VideoCapture::VideoCapture(cv::String const&, int)

已尝试的无效操作 #

• 将argv[1]转换为cv::String类型传入构造函数
• 显式添加API模型参数（如cv::CAP_ANY）作为构造函数第二个参数

环境信息 #

• OpenCV 3.4.1（Cygwin仓库安装版本）
• Cygwin 3.6.9 x64
• GCC 13

解决方法 #

1. 调整链接库顺序与依赖 #

OpenCV库存在依赖关系，仅链接opencv_videoio可能遗漏核心依赖。使用以下命令重新链接，确保库的顺序符合依赖逻辑：

g++ -g opencvread.o -L/usr/lib -lopencv_videoio -lopencv_core -o opencvread

或者直接利用pkg-config自动生成完整的链接参数：

g++ -g opencvread.o -L/usr/lib `pkg-config --libs opencv` -o opencvread

2. 统一C++标准与显式类型转换 #

OpenCV 3.4.1默认基于C++11编译，确保编译时指定对应标准，并显式构造cv::String避免隐式转换的ABI差异：
修改代码中的构造函数调用：

cv::VideoCapture cap(cv::String(argv[1]));

重新编译时添加C++标准参数：

g++ -c -g -std=c++11 opencvread.cpp -o opencvread.o

3. 重新安装OpenCV依赖包 #

确保Cygwin中OpenCV相关组件完整安装，执行以下命令重新安装：

apt-cyg install libopencv-devel libopencv-videoio-devel

（若使用Cygwin图形安装界面，可重新勾选OpenCV相关开发包进行安装）

4. 简化代码排除干扰 #

暂时移除filesystem相关代码，排除该库可能带来的编译/链接冲突，测试最简版本的视频读取逻辑：

#include <iostream>
#include <opencv2/opencv.hpp>

int main(int argc, char *argv[])
{
    cv::VideoCapture cap(cv::String(argv[1]));
    if (cap.isOpened()) {
        cap.release();
        std::cout << "OK!\n";
    } else {
        std::cerr << argv[1] << ": can't open video for reading\n";
    }
    return 0;
}

内容的提问来源于stack exchange，提问作者david furst