计算机视觉库 OpenCV 下载安装（2026）

发布时间：2026/10/31 6:41:05
计算机视觉库 OpenCV 下载安装（2026）

计算机视觉库 OpenCV 下载安装

目录

计算机视觉库 OpenCV 下载安装

前言

一、OpenCV 框架概述

1.1 什么是 OpenCV

1.2 核心应用领域

1.3 环境准备与版本说明

二、下载与安装

2.1 下载 OpenCV 库

2.2 安装 CMake 工具

三、系统环境变量配置

3.1 配置 MinGW 环境变量

3.2 后续 OpenCV 环境变量配置

四、使用 CMake 编译配置 OpenCV

4.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

🔍 OpenCV（Open 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.msi）

3. 安装时务必勾选 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 code：D:\opencv\sources

Where to build the binaries：D:\opencv\build

4.2 配置生成器

  1. 点击Configure按钮，若目录不存在，点击 “是” 创建目录
  2. 在弹出的对话框中选择：
    • Specify the generator for this project:MinGW Makefiles
    • 选择Specify native compilers
  3. 点击Next，配置 C 和 C++ 编译器路径：
    • C 编译器：C:\Qt\Qt5.12.9\Tools\mingw730_64\bin\gcc.exe
    • C++ 编译器：C:\Qt\Qt5.12.9\Tools\mingw730_64\bin\g++.exe
  4. 点击Finish，等待第一次配置完成（过程中需下载依赖文件，确保网络畅通）

4.3 关键编译选项勾选

完成第一次基础 Configure、编译器识别成功之后，我们需要在 CMake 的参数列表中勾选需要的功能模块，这一步决定编译出来的 OpenCV 库支持哪些扩展能力。

  1. 搜索框输入WITH_QT，勾选该选项：开启 OpenCV 对 Qt 的支持，后续可以直接在 Qt 项目里调用 OpenCV，实现图像窗口展示、GUI 联动，是 Qt+OpenCV 开发最核心的选项。
  2. 搜索框输入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，如下图所示。
  • 常见踩坑：
    1. Generate 报错：检查源码路径sources和构建路径build不能带有中文、空格；你这里路径D:/Program Files (x86)/opencv/带空格，MinGW 编译时偶尔会出兼容问题，推荐后续读者尽量使用无空格路径，例如D:/opencv/build。
    2. 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 参数为单线程编译，速度很慢，整个编译过程通常几十分钟。

⚠️ 编译过程注意事项：

  1. 编译全程保持网络通畅，部分第三方依赖包会在线拉取；
  2. 不要关闭 CMD 窗口，不要休眠电脑；
  3. 编译报错：优先检查 CMake 阶段 Configure 是否全绿、Qt/MinGW 版本匹配，Qt5.12.9 配套 mingw73_64 是稳定组合，不要混用其他版本 mingw；
  4. 磁盘空间提醒：完整编译后的 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/lib，dll 运行库复制到install/bin；
  • 这一步不会联网下载任何文件，只是搬运刚才编译成功的产物；
  • 如果编译阶段报错、中途终止，直接执行 install 会失败，必须保证上一步编译 100% 完成无报错。

⚠️ 避坑提醒：

  1. 命令行最好以管理员身份打开，防止权限不足导致文件拷贝失败；
  2. 路径不要包含中文、空格、特殊字符；
  3. 若提示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\bin

2、和前面配置 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 找不到的经典报错。