OpenCV 4 Windows安装教程详解
经过几个月的努力，小白终于完成了市面上第一本OpenCV4入门书籍《从零学习OpenCV4》。为了更让小伙伴更早的了解最新版的OpenCV4，小白与出版社沟通，提前在公众号上连载部分内容，请持续关注小白。小白学视觉大多数的学生开发者使用的是Windows系统，在Windows系统中就不得不提到微软强大的VisualStudio集成开发环境（IDE），VisualStudio拥有大量不同的版本，而不同版本对于OpenCV版本的兼容性也不尽相同。虽然已经发布VisualStudio2019，但是
经过几个月的努力，小白终于完成了市面上第一本OpenCV 4入门书籍《从零学习OpenCV 4》。为了更让小伙伴更早的了解最新版的OpenCV 4，小白与出版社沟通，提前在公众号上连载部分内容，请持续关注小白。
小白学视觉
大多数的学生开发者使用的是Windows系统，在Windows系统中就不得不提到微软强大的Visual Studio集成开发环境（IDE），Visual Studio拥有大量不同的版本，而不同版本对于OpenCV版本的兼容性也不尽相同。虽然已经发布Visual Studio 2019，但是目前OpenCV 4.1仅支持Visual Studio 2015和Visual Studio 2017两个版本。因此对于在Windows环境下使用OpenCV4.1版本的开发者，需要将IDE更新到提到的两个版本。Visual Studio的安装和使用并不是本书的重点，读者可以去微软官网下载需要的版本，按照教程完成安装和使用。笔者使用的是Visual Studio 2015版本，因此推荐读者在学习本书的过程中与笔者使用同一版本IDE，这样可以减少在运行示例代码过程中的调试时间，将更多的精力用在学习OpenCV的算法和代码中。
在Windows环境下安装主要包含5个步骤，分别是下载和安装OpenCV SDK、配置包含路径、配置库目录、配置链接器、配置环境变量。当每一步都配置完成后便可以开始OpenCV的学习之旅，接下来将会对每一步进行详细的介绍。
1
01
下载和安装OpenCV SDK
OpenCV SDK获取非常简单，通过搜索引擎可以直接搜索到OpenCV官网，在官网中找到Releases选项，里面会有历史发布的OpenCV各个版本，找到OpenCV 4.1版本的下载界面，发现有多个可以选择项，如图1-1所示。其中Docs选项链接OpenCV的文档库包含模块组成、函数介绍等内容，不过很可惜文档全部是英文的，部分同学阅读起来还是存在着很多不方便之处。Sources选项是Ubuntu等Linux系统下的安装包，关于其安装方式，我们会在后面介绍。GitHub选项链接到GitHub中OpenCV 4.0版本的下载文件，其内容与通过其他选项下载的内容是一致的。Windows选项、iOS pcak选项和Android选项分别是在Windows系统、iOS系统和Android系统下的安装包。很遗憾OpenCV4.0并不支持Android环境的开发，但是OpenCV 4.1版本已经支持Android环境。最后一个选项Release Notes选项是最新版本的更新信息。
图1-1 OpenCV 4.0版本安装包下载区域
下载完成后得到“opencv-4.1.0-vc14_vc15.exe”文件，便可以开始安装过程。其实所谓的安装是一个解压的过程，可执行文件是一个自解压的程序，双击后便会提示我们选择解压路径。这里根据自己需求选择路径即可，特别要说明的是，该程序会将所有文件解压在opencv的文件夹下，因此不需要在选择解压路径中单独新建一个opencv文件夹。由于笔者电脑安装了多个版本的OpenCV，为避免混淆，单独创建一个名为opencv4的文件夹，解压到H:\opencv4。选择好路径后点击【Extract】按钮，便可以等待解压过程的结束。整个OpenCV4的大小约为1G，根据电脑的性能不同，等待时间从几十秒到几分钟不等。安装过程图片如图1-2和图1-3所示。
图1-2 选择提取OpenCV路径
图1-3 等待解压过程
解压结束后，去刚才选择的路径下查看是否多了一个名为opencv的文件夹，该文件夹内含有build和sources两个子文件夹，如果没有，说明解压错误，建议删除后重新解压。build文件夹是主要的OpenCV相关文件，里面含有头文件与库文件等重要信息，接下来的环境配置工作都将围绕其展开。sources文件夹里放置的是源码以及例程和图片，后续也会对其中的部分进行介绍。如果想减少占用硬盘空间，原则上可以删除sources文件夹，但是这里并不推荐大家这样做，毕竟大多数情况下我们计算机的硬盘空间是充足的。
1
02
配置包含路径
配置环境主要目的是告诉你的计算机你安装的OpenCV放在哪里，以及告诉你的IDE应该去哪里寻找头文件与库文件。为了完成与IDE的沟通，我们首先启动Visual Studio 2015，创建一个新的项目。在弹出的新项目选项中，查看自己已安装的Visual Studio内容，选择Visual C++中的Win32选项，在Win32项目和Win32控制台应用程序中选择后者。根据我们需求修改项目名称，选择存放的位置。为了测试OpenCV，我们将项目名称修改为opencv4_test，存放在F:\opencv\内，如图1-4所示。
图1-4 创建Win32控制台应用程序界面
完成项目名称填写后，点击【确定】按钮，会跳转出Win32应用向导，这里需要修改“附加选项”：选择“空项目”，取消“安全开发生命周期（SDL）检查”选项，点击【完成】按钮，完成空项目的创建。如图1-5所示
图1-6 空项目的解决方案资源管理器
图1-7 向“源文件”中添加空白cpp文件
然后修改界面上方的“Debug”模式，将其修改为“x64”模式，如图1-8所示。
图1-8 修改Debug模式为x64
在完成空项目的创建之后，正式开始包含路径的配置。依次点击界面上方的【视图】→【其他窗口】→【属性管理器】，在右侧会出现“属性管理器”界面，如图1-9所示。打开“Debug | x64”前方的小三角形，双击【Microsoft.Cpp.x64.user】打开属性页，如图1-10所示。
图1-9 属性管理器界面
图1-10 属性页
属性页中的“VC++目录”中的“包含目录”、“库目录”和“链接器”中的“附加依赖项”便是我们需要修改的地方。在“包含目录”里添加两个文件路径，分别是：
H:\opencv4\opencv\build\includeH:\opencv4\opencv\build\include\opencv2重点需要留意一下，这里不同于之前版本，这里包含目录里只有两个，取消了原来的…\inclde\opencv这个路径，是因为在…\include\这个文件夹里只有一个opencv2文件夹，OpenCV 4.1将两个文件夹合并在了一起。添加完成两个路径后，便完成了包含路径配置工作。
1
03
配置库目录
库目录配置过程与包含路径配置过程相似，只需要寻找到对应的目录路径即可。笔者的配置路径如为：
H:\opencv4\opencv\build\x64\vc14\lib
需要说明的是，“…\vc14\”指的是在Visual Studio 2015中使用，而如果使用的是Visual Studio 2017版本，就需要选择“…\vc15\”。这里如果选择错误，就会造成版本不兼容的问题，会出现配置失败的一系列问题。所以读者一定要根据自己的实际情况而选择。
1
04
配置链接器
链接器的配置应该是OpenCV 4.1最大的改变，为了极大的方便开发者使用，节省配置时间，它简化了库文件中的lib文件数目。打开库目录路径，发现lib文件数目只有两个，如图1-11所示。这两个文件的名字很像，唯一区别就是一个后面含有“d”，而另一个没有。不含有的文件是在Release模式下使用，配置该模式的时候才使用。含有“d”的文件是在Debug模式下使用的，由于我们现在是在Debug模式下，因此我们选择此文件。打开链接器左侧的三角形，在“输入”项中的“附加依赖项”添加opencv_world400d.lib，完成链接器的配置。
图1-11 库文件中的lib文件
1
05
配置环境变量
我们完成了告诉Visual Studio 2015去哪里寻找OpenCV的工作，接下来该告诉计算机OpenCV在哪里。找到“我的电脑”，右键选择【属性】，打开电脑的系统设置界面，并选择【高级系统设置】，进入系统属性界面。如图1-12所示。
图1-12 系统设置界面
在系统属性界面内选择【环境变量】，并在新跳转出的页面中的“系统变量”部分找到“Path”变量，如图1-13所示，在其后面添加如下路径：
H:\opencv4\opencv\build\x64\vc14\bin
这里要注意，我们会在用户变量和系统变量里都会发现“Path”变量。理论上两者只需要配置一个就可以完成，但是一台计算机上可能拥有多个用户，因此建议在系统变量里添加路径。同时，由于可能前期配置过其他的变量，在添加OpenCV变量的同时，不要将之前的配置内容是删除，而是使用分号将不同的路径分开，避免对其他环境产生影响。
图1-13 系统环境变量配置界面
1
06
验证配置结果
完成了所有的配置过程后，需要通过程序验证配置是否成功。但是在此之前需要说明的是，配置流程没有顺序要求，即可以先完成Visual Studio的配置工作再完成计算机环境变量的配置，也可以反过来进行。不过需要说明的是，按照本书的流程进行配置，在配置完成后需要重启Visual Studio才可以在程序中加载OpenCV的头文件。
我们在前面创建的main源文件中输入代码清单1-1中的程序，该程序的主要目的是读取一张图片并显示该图片，代码原理我们会在后面的章节中详细介绍。现在只需要将代码输入，构建解决方案，运行程序验证环境配置是否成功。
代码语言：javascript代码运行次数：0运行复制代码清单1-1 install_test.cpp测试OpenCV 4.1是否安装成功1. #include //加载OpenCV 4.1头文件2. #include 3. 4. using namespace std;5. using namespace cv; //opencv的命名空间6. 7. int main()8. {9. Mat img; //声明一个保存图像的类10. img = imread("G:/opencv/lena.png"); //读取图像，根据图片所在位置填写路径即可11. if (img.empty()) //判断图像文件是否存在12. {13. cout << "请确认图像文件名称是否正确" << endl;14. return -1;15. }16. imshow("test", img); //显示图像17. waitKey(0); //等待键盘输入18. return 0; //程序结束19. } 运行如上程序，我们得到如图1-14的结果，证明OpenCV环境配置成功，可以开启OpenCV的学习之路了。
Postman是一套面向API全生命周期的开发与测试平台，可在Mac上发送和调试多种协议请求，管理集合、环境及认证信息，并完成脚本测试、模拟服务、监控、文档发布和团队协作。它适合开发、测试及运维人员使用，提供个人免费方案。
Docker Desktop 是 Docker 官方为 Mac 提供的容器开发环境，集成 Docker Engine、命令行工具、Compose、Build、Kubernetes 与图形化管理界面。
Android Studio 是 Google 面向安卓应用开发提供的官方集成开发环境，基于 IntelliJ IDEA 构建。它整合智能代码编辑、Gradle 构建、界面预览、设备模拟、性能分析、调试测试及 APK 分析等工具。
Xcode 是苹果面向 Mac 提供的官方集成开发环境，将代码编辑、项目构建、SwiftUI 实时预览、设备模拟、自动化测试、断点调试、性能分析和应用分发整合在同一套工作流中，适合开发与维护 iPhone、iPad、Mac、Apple Wa
JetBrains WebStorm 是面向 JavaScript、TypeScript 和现代 Web 技术的专业集成开发环境，可智能理解项目结构，提供代码补全、重构、错误检查、运行调试、测试及 Git 工具。
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境，可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
JetBrains PyCharm 是面向 Python 开发者的集成开发环境，提供智能补全、代码检查、重构、调试、测试、版本控制及虚拟环境管理功能。Mac 版兼容 Intel 与 Apple 芯片，核心功能可免费使用。
IntelliJ IDEA 是 JetBrains 推出的专业集成开发环境，重点服务于 Java、Kotlin 与 JVM 项目开发。软件集成代码补全、静态检查、重构、调试、测试、版本控制及构建工具，并可借助插件扩展语言和框架支持。
Visual Studio Code 是微软提供的免费代码编辑器，支持 macOS，并为 Intel 与 Apple 芯片 Mac 提供适配版本。软件集代码编辑、调试、Git 源代码管理、集成终端和扩展市场于一体。
REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Pro Tools 是 Avid 推出的专业数字音频工作站，覆盖多轨录音、无损剪辑、MIDI 编曲、插件处理、自动化混音及声音与画面同步等工作。它拥有 Intro、Artist、Studio 和 Ultimate 等方案。
Postman 是面向 API 全生命周期的开发与协作平台。Windows 桌面版可用于构建和发送 HTTP、GraphQL、gRPC、WebSocket、MQTT 等请求，并提供环境变量、集合、脚本测试、模拟服务、监控、文档及团队工作区等
Docker Desktop 为 Windows 开发者提供集成式容器环境，内置 Docker Engine、命令行工具、Compose、Build 与 Kubernetes 等组件，可在本机完成镜像构建、容器运行、日志查看和资源管理。
Android Studio 是 Google 面向 Android 应用开发提供的官方集成开发环境，以 IntelliJ IDEA 为基础，集成智能代码编辑、Gradle 构建、设备模拟、界面预览、调试测试及性能分析工具，
WebStorm 是 JetBrains 面向 JavaScript、TypeScript 和现代 Web 技术打造的集成开发环境。它提供项目级代码分析、智能补全、安全重构、导航搜索，并集成调试、测试、终端、Git 与常用前端工具，
PhpStorm 是 JetBrains 面向 PHP 与现代 Web 开发打造的专业集成开发环境，提供代码补全、静态检查、重构、调试、测试、数据库、版本控制及前端语言支持。Windows 用户可直接下载安装程序，
PyCharm 是 JetBrains 推出的 Python 集成开发环境，提供智能代码补全、错误检查、重构、调试、测试、Git、终端及 Jupyter Notebook 支持。统一版安装后可体验 30 天 Pro 功能，
JetBrains IntelliJ IDEA 是以 Java、Kotlin 和 JVM 项目为核心的专业集成开发环境，提供智能补全、代码检查、安全重构、调试、测试、版本控制及构建工具集成。统一发行版的核心功能可免费用于商业和非商业项目，
Visual Studio Code 是微软推出的免费代码编辑器，Windows 版集成智能补全、代码导航、调试、终端和版本控制，并可通过扩展添加语言、格式化及远程开发能力。它启动较快、配置灵活，
REAPER 是 Cockos 推出的数字音频工作站，适用于录音、MIDI 编曲、音频编辑、混音、母带制作及声音设计。软件安装包小巧，支持多轨录制、灵活路由、自动化、第三方插件和脚本扩展，并提供完整功能的 60 天免费评估期。
Adobe Audition 是面向播客、影视后期、广播与音乐制作的专业音频工作站，提供波形编辑、多轨混音、频谱分析、录音、降噪修复和效果处理等功能。Windows 版通过 Adobe Creative Cloud 安装和管理，
Pro Tools 是 Avid 推出的专业数字音频工作站，提供多轨录音、音频剪辑、MIDI编曲、插件处理、自动化混音及影视声音制作能力。它适合音乐人、录音师、制作人和音频后期团队使用，并提供免费入门版、订阅方案及永久授权选择。
Cubase 是 Steinberg 推出的数字音频工作站，提供 MIDI 编曲、多轨录音、音频编辑、虚拟乐器、效果处理、自动化、混音和母带输出工具。其 Pro、Artist 与 Elements 版本面向不同预算和制作规模，