)
计算机视觉库 OpenCV 下载安装目录计算机视觉库 OpenCV 下载安装前言一、OpenCV 框架概述1.1 什么是 OpenCV1.2 核心应用领域1.3 环境准备与版本说明二、下载与安装2.1 下载 OpenCV 库2.2 安装 CMake 工具三、系统环境变量配置3.1 配置 MinGW 环境变量3.2 后续 OpenCV 环境变量配置四、使用 CMake 编译配置 OpenCV4.1 启动 CMake 图形界面4.2 配置生成器4.3 关键编译选项勾选4.4 二次 Configure生成 Makefile 构建脚本4.5 MinGW 命令行编译 OpenCV 源码4.5.1 前置校验4.5.2 进入编译目录4.5.3 启动编译4.6 安装编译产物4.6.1 执行安装命令4.6.2 配置 OpenCV 系统环境变量4.6.3 验证整套编译 安装是否成功4.6.4 后续Qt 项目引入我们自己编译的 OpenCV预告五、总结前言本文详细介绍了在 Windows 11 (x64) 系统下基于 Qt 5.12.9 开发环境配置 OpenCV 4.3.0 计算机视觉库的完整流程。内容涵盖 OpenCV 与 CMake 的下载安装、系统环境变量配置、使用 CMake 编译 OpenCV 源码以及在 Qt Creator 中创建测试项目验证环境可为后续 Qt OpenCV 联合开发如人脸识别考勤系统奠定基础。一、OpenCV 框架概述1.1 什么是 OpenCV OpenCVOpen Source Computer Vision Library是由 Intel 公司开发的一个开源、跨平台计算机视觉库实现了图形图像处理和计算机视觉领域中的大量算法。该库使用 C 和 C 语言编写主要接口是 C同时提供 Python、Java、Matlab 等语言的接口绑定支持 Windows、Linux、Android、iOS、FreeBSD和Mac OS 等操作系统。1.2 核心应用领域 图像数据操作 图像处理算法 矩阵计算及线性代数算法 运动跟踪与分析 目标识别 机器学习1.3 环境准备与版本说明✅操作系统Windows 11(x64)✅Qt 版本Qt 5.12.9自带 MinGW 7.3.0 64-bit 编译器✅OpenCV 版本4.3.0✅CMake 版本4.2.3二、下载与安装2.1 下载 OpenCV 库1. 访问 OpenCV 官方下载页https://opencv.org/releases/打开网页后可看到各个Open CV库的版本本文使用的是4.3.0版。2. 选择 4.3.0 版本点击 Windows 平台下载文件名为 opencv-4.3.0-vc14_vc15.exe。官网下载很慢可以找别的资源下载安装。3. 下载完毕后双击安装文件这里的安装实际上是一个解压缩的过程将文件解压到指定的位置(本文设置的目录为D:\)。选择一个安装路径点击Extract等待安装完成。2.2 安装 CMake 工具️ CMake是一个跨平台的编译配置工具此处用它实现Open CV库针对MinGW编译器的编译配置。CMake的下载地址为 https://cmake.org/download/ 。本文安装的是4.2.3版的 Windows版本安装文件名为 cmake-4.2.3-windows-x86_64.msi 也可选择网站上提供的其他版本。1. 访问 CMake 下载页https://cmake.org/download/2. 下载 Windows 版本本文使用 4.2.3文件名为 cmake-4.2.3-windows-x86_64.msi3. 安装时务必勾选 Add CMake to the system PATH for all users 选项将 CMake 添加到系统环境变量。双击安装文件单击 Next 按钮勾选 I accept the terms in the License Agreement 选项继续单击 Next 按钮。进入如下图所示的安装选项界面勾选Add CMake to the PATH environment variable 选项。选择安装路径。准备安装。等待安装。完成安装。三、系统环境变量配置3.1 配置 MinGW 环境变量➕ 首先将MinGW添加到系统环境变量中以便系统能自动找到MingGW工具。右键 “此电脑” →属性→高级系统设置→环境变量在系统变量Path中添加 MinGW 路径ℹ️ 注意本文我的Qt安装在D:\PCzyxxrj\Qt\Qt5.12.9路径下自带的 MinGW 工具的目录为D:\PCzyxxrj\Qt\Qt5.12.9\Tools\mingw730_64\bin可根据自己实际的Qt安装目录参照找到MinGW工具的路径并设置。下图中第7步中路径有问题仅供参考我的Qt中自带的 MinGW 工具的目录为D:\PCzyxxrj\Qt\Qt5.12.9\Tools\mingw730_64\bin可根据自己安装目录配置变量路径完成后依次点击确定保存。补充3.2 后续 OpenCV 环境变量配置编译完成后还需将 OpenCV 输出目录下的bin文件夹添加到系统Path注此步骤需在编译完成后执行重启计算机使路径生效。四、使用 CMake 编译配置 OpenCV前面下载并解压后的Open CV库需要经过编译才能使用。在此之前首先使用CMake工具进行一些编译配置。4.1 启动 CMake 图形界面1. 从开始菜单启动CMake (cmake-gui)2. 配置源码与编译输出目录Where is the source codeD:\opencv\sourcesWhere to build the binariesD:\opencv\build4.2 配置生成器点击Configure按钮若目录不存在点击 “是” 创建目录在弹出的对话框中选择Specify the generator for this project:MinGW Makefiles选择Specify native compilers点击Next配置 C 和 C 编译器路径C 编译器C:\Qt\Qt5.12.9\Tools\mingw730_64\bin\gcc.exeC 编译器C:\Qt\Qt5.12.9\Tools\mingw730_64\bin\g.exe点击Finish等待第一次配置完成过程中需下载依赖文件确保网络畅通4.3 关键编译选项勾选完成第一次基础 Configure、编译器识别成功之后我们需要在 CMake 的参数列表中勾选需要的功能模块这一步决定编译出来的 OpenCV 库支持哪些扩展能力。搜索框输入WITH_QT勾选该选项开启 OpenCV 对 Qt 的支持后续可以直接在 Qt 项目里调用 OpenCV实现图像窗口展示、GUI 联动是 QtOpenCV 开发最核心的选项。搜索框输入WITH_OPENGL勾选该选项开启 OpenGL 硬件渲染加速高分辨率图像、视频流显示会更加流畅。 补充说明博客小贴士如果你不需要 Qt 开发可以不勾选WITH_QT编译速度会更快勾选后 CMake 会自动检索本机 Qt 的 MinGW 编译套件路径也就是我们前面配置的 Qt5.12.9 mingw73_64。其余选项默认即可WITH_PNG/WITH_JPEG等图片编解码默认勾选CUDA、IPP、Vulkan 这类硬件加速项如果没有显卡驱动和对应 SDK保持不勾选避免配置报错。不建议开启大量 TEST、EXAMPLE 示例代码会成倍拉长编译时间适合仅开发使用的场景。勾选完成后再次点击下方的Configure按钮CMake 会重新扫描依赖、校验 Qt 头文件与库路径。✅正常现象界面会刷新Qt 相关路径Qt5Core_DIR、Qt5Gui_DIR、Qt5Widgets_DIR等自动填充为你本地 Qt 的 mingw 库目录红色条目消失代表依赖识别成功。4.4 二次 Configure生成 Makefile 构建脚本等待二次 Configure 执行完毕日志栏输出Configuring done代表所有参数、依赖校验全部通过。接下来点击界面下方的Generate按钮CMake 会根据你选择的MinGW Makefiles生成器在build目录下生成 MinGW 可识别的 Make 编译脚本。成功标志底部日志输出Generating done如下图所示。常见踩坑Generate 报错检查源码路径sources和构建路径build不能带有中文、空格你这里路径D:/Program Files (x86)/opencv/带空格MinGW 编译时偶尔会出兼容问题推荐后续读者尽量使用无空格路径例如D:/opencv/build。Qt 路径 NOT FOUND确认 Qt 的 mingw73_64/bin 已经加入系统环境变量并且 CMake 里的WITH_QT开启后重新 Configure。备注到这里 CMake 图形界面的工作就全部结束了不要关闭 CMake可选接下来转到 CMD 终端调用 MinGW 工具链执行源码编译。4.5 MinGW 命令行编译 OpenCV 源码4.5.1 前置校验打开 CMD 终端先确认 MinGW 环境变量生效Qt\Qt5.12.9\Tools\mingw730_64\bin已经加到系统 PATH这个目录内包含gcc.exe、g.exe、mingw32-make.exe。验证命令gcc -v g -v mingw32-make -v输出版本号代表环境正常若提示不是内部命令需要重新配置系统环境变量。4.5.2 进入编译目录在 CMD 依次输入下面两条命令切换到我们 CMake 生成脚本的 build 目录D: cd D:\Program Files (x86)\opencv\build说明第一条D:切换盘符第二条 cd 进入 build 构建文件夹Makefile 文件就存放在这个目录下。4.5.3 启动编译执行编译命令mingw32-make # 或者 mingw64-make进阶优化推荐多线程加速编译6 核 CPU 示例具体核数根据自己电脑进行执行mingw32-make -j6-j 数字代表使用多线程并行编译数字一般设置为 CPU 核心数大幅缩短编译耗时不加 - j 参数为单线程编译速度很慢整个编译过程通常几十分钟。⚠️ 编译过程注意事项编译全程保持网络通畅部分第三方依赖包会在线拉取不要关闭 CMD 窗口不要休眠电脑编译报错优先检查 CMake 阶段 Configure 是否全绿、Qt/MinGW 版本匹配Qt5.12.9 配套 mingw73_64 是稳定组合不要混用其他版本 mingw磁盘空间提醒完整编译后的 OpenCV 产物体积很大推荐放在 D 盘避免 C 盘爆满。✅ 编译成功标志CMD 终端无 error 报错全部目标文件编译完成此时 build 目录下已经生成动态库、静态库。4.6 安装编译产物本章前面我们已经通过mingw64-make完成 OpenCV 的源码编译编译生成的库文件、头文件都存放在我们 CMake 指定的install目录下这一步就是把编译好的产物安装到系统方便后续 Qt / 其他 MinGW 项目调用。4.6.1 执行安装命令回到 MinGW 命令行窗口依旧在我们的 build 编译目录下执行安装mingw32-make install✅ 说明install动作会自动把头文件复制到install/include动态库、静态库复制到install/libdll 运行库复制到install/bin这一步不会联网下载任何文件只是搬运刚才编译成功的产物如果编译阶段报错、中途终止直接执行 install 会失败必须保证上一步编译 100% 完成无报错。⚠️ 避坑提醒命令行最好以管理员身份打开防止权限不足导致文件拷贝失败路径不要包含中文、空格、特殊字符若提示target does not exist代表前面的编译没有完整跑完需要回到 4.5 重新编译。等待命令执行完毕没有红色报错就代表安装成功。打开我们的 install 目录可以看到目录结构install ├─ bin # opencv_worldxxx.dll 动态运行库 ├─ include # OpenCV 所有头文件core、highgui、imgproc等 └─ lib # .a 库文件链接阶段使用4.6.2配置 OpenCV 系统环境变量1、复制install/bin的完整路径示例D:\PCzyxxrj\Qt\opencv-build\install\bin2、和前面配置 MinGW 一样此电脑 → 右键【属性】→ 高级系统设置 → 环境变量 → 系统变量找到Path点击【编辑】→【新建】粘贴上面这条 bin 路径。3、一路点击【确定】保存所有窗口。原理把 OpenCV 的 dll 目录加入系统 Path之后我们写的程序运行时Windows 才能找到 OpenCV 的动态链接库否则运行程序直接提示缺少 opencv_world4xxx.dll。✅ 重要环境变量修改之后所有已经打开的 cmd、Qt Creator 全部关闭重启新环境变量才会生效4.6.3 验证整套编译 安装是否成功重启 cmd依次校验# 校验MinGW编译器 g --version # 校验opencv版本如果编译时开启了opencv_version工具 opencv_version如果能正常输出版本号代表环境、库都安装就绪。4.6.4 后续Qt 项目引入我们自己编译的 OpenCV预告在 Qt 的 .pro 文件中需要手动指定头文件路径和库路径示例模板# OpenCV头文件目录 INCLUDEPATH D:\PCzyxxrj\Qt\opencv-build\install\include LIBS -LD:\PCzyxxrj\Qt\opencv-build\install\lib \ -lopencv_world455这里库名opencv_world455需要和你编译出来的 lib 文件名保持一致版本号以你源码版本为准。五、总结mingw32-make install本质是部署编译成品编译 生成二进制库install 整理、输出可给外部项目使用的头文件 库追加 OpenCV bin 到 Path 解决运行时 dll 找不到的经典报错。