OpenCV3.4.1和VS2017配置过程详解

欢迎学习交流！
邮箱： z…@1…6.com
网站： https://zephyrhours.github.io/

前言

由于科研工作的需求，笔者需要用到OpenCV来进行相关的图像处理工作，然而笔者在安装和饿配置OpenCV 环境的过程也实在走了不少的弯路。前人栽树，后人乘凉，为了让后来者少走些弯路，笔者决定将自己血的教训记录下来，以供后人参考，少走弯路。

注意： 安装的OpenCV版本需要和VS版本严格对应，否则在使用过程中容易各种bug，虽然可以解决，但是尽量按照要求来装，以免不必要的麻烦。
版本要求：

• Visual Studio 2017 社区版，无需破解，轻松安装，快速使用
• OpenCV 3.4.1

一、软件下载

正所谓兵马未动粮草先行，所以在软件配置及安装前，首先需要我们把相关的软件下载下来，为了方便大家，下面笔者给出大家下载路径，大家可以根据需要自行下载，也可以在我给大家分享的百度网盘进行下载。

1. 下载VS 2017

下载方案一：官方网站进行下载
现在VS2019已经发部，所以现在找的VS版本基本上都是指向最新的vs2019，对于想用vs2017的朋友，下面笔者提供链接，如果需要可以自行下载。需要注意的是：现在下载这个版本VS需要登陆自己的微软账户才行，否则无法下载。
https://docs.microsoft.com/en-us/visualstudio/releasenotes/vs2017-relnotes

下载方案二：从笔者的百度网盘进行下载
其实无论是从官方网站下载还是从笔者的百度网盘进行下载，下载的都是一个1M的安装引导程序，所以为了方便大家，下面奉上笔者自己收藏的VS2017社区版的安装引导程序，大家可以从我的百度网盘进行下来。

VS 2017社区版（Community）下载地址：
链接：https://pan.baidu.com/s/1sdmQl25JopvxTsJNpYaqbg
提取码： lyrk

下载的文件，其大小不足 1 MB，只是 VS 2017 Community 简体中文版的一个安装引导程序。启动后勾选需要的组建即可进行在线下载安装。

2. 下载OpenCV

下载地址一：官方网站下载（强烈建议）
强烈建议读者从官方网站进行下载，这里读者可以根据自己下需要进行相关版本的下载，因为我使用的是 VS2017，它与 OpenCV3.4.1 是相互兼容的，因此下面以 OpenCV3.4.1 为例子进行说明。

• 首先下载 OpenCV，网上查找OpenCV 即可找的相关网站： https://opencv.org/
• 进入 OpenCV releases 页面，找到相对应的版本，点击 "Windows"的下载链接。之后会跳到
  sourceforge.net 网站，等待几秒钟之后，浏览器就会自动开始下载,下载过程会稍微比较久，需要耐心等待。
  
  
  下载方案二：从笔者的百度网盘进行下载
  下面是笔者的百度网盘链接，如果需要也可以从笔者百度网盘进行下载，但是百度网盘限速严重，建议大家使用第一种方法进行下载。注意版本之间的兼容性问题，所以一定要下载对应的版本才行。
  链接： https://pan.baidu.com/s/1aJo32Si8mM73ZQ_PIfieOA
  提取码： oq64

二、软件安装

在下载好之后，接下来就是软件的安装过程了，老手可以直接跳过此部分，新手一定要按照步骤来完成。

1. 安装 VS 2017

VS 2017 下载完成后，会得到一个用于引导用户安装的可执行文件，双击该文件，在 .Net Framework 版本没有问题的前提下，会进入安装页面：

直接点击 “继续” 按钮，此时会弹出一个进度条：

等 Visual Studio 准备完成后，会直接跳到下面的页面：

VS 2017 除了支持 C/C++ 开发，还支持 C#、F#、Visual Basic 等开发语言，我们没有必要安装所有的组件，只需要安装 使用C++ 的桌面开发 即可。
同时在这个页面，还可以选择 VS 2017 的存储位置，建议不要安装在 C 盘，可选择其他盘。然后直接点击安装，安装过程可能需要一段时间，大家耐心等待。

安装完成后，有些电脑会出现 VS 2017 求重启计算机，该保存的保存，按要求重启即可。

重启完成后，打开 “开始菜单”，会发现多了一个叫 “Visual Studio 2017” 的图标，证明你安装成功啦。

双击启动 Visual Studio 2017，会提示让你登陆，可以直接略过，以后再说。

安装成功后，首次使用 VS 2017 还需要对其进行简单的配置，包括开发环境和软件本身的主题风格。我们使用 VS 2017，主要进行的是 C/C++ 程序开发，所以选择 “Visual C++” 这个选项，至于颜色主题，随你喜欢，4 选 1 即可，然后点击 “启动 Visual Studio” 按钮。

最后，等待几分钟的准备过程，VS2017 就启动成功啦！

2. 安装 OpenCV3.4.1

在安装好VC之后，下面就是OpenCV 的配置和安装了。找到之前下载好的安装包，双击运行 opencv-3.4.1-vc14_vc15.exe（这其实是一个解压过程），安装文件,会询问解压存放的路径，解压即是安装。
建议： 在英文路径下，不用有中文和空格。

选择解压存放的文件夹就可以，这里也就是所谓的安装的软件的具体位置。OpenCV 项目文件打包时，根目录为 opencv，所以我们不需要额外的新建一个名为 opencv 的文件夹。
在解压之后的文件夹中，bulid 里面是使用 OpenCV 的相关文件，sources 里面是源代码。

三、环境配置

在安装VS2017和OpeCV3.4.1之后，还需要对其进行配置，尤其是OpenCV，因为它的安装过程其实就是解压的过程，其注册表和环境变量等信息并没有自动写入，因此在使用前，需要我们手动地进行环境变量的配置。

1. OpeCV的环境变量设置

右键点击此电脑，选择 属性，在控制面板中选择 高级系统设置，在弹出的系统属性面板中选择 高级，之后选择最下面的 环境变量。具体如下：


下面进行环境变量的具体配置，此处进行环境变量配置可以有两种方式：一种是将其添加在 用户变量 中，第二种就是将其添加在 系统变量 中。这里根据读者的需要自行选择。区别：在用户变量中添加的只有用户自己可以使用，此电脑的其他用户则无法使用。在系统变量中添加的则整个电脑的所以用户都可以使用。此处笔者添加在了系统变量中。选择好之后点击下面的编辑按钮，进入路径添加界面。

在 编辑环境变量 窗口中填入路径，把之前解压（安装）好的OpenCV路径下的bin路径添加到Path系统环境变量中，这里根据自己的存放路径进行添加。
如我存放的路径是 D:\Program Files\opencv\build\x64\vc15\bin

然后 确认 就会关闭 编辑环境变量 的窗口，然后依次将已打开的 环境变量 和 系统属性窗口，都点击 确定，来关闭打开的窗口。此时就已经完成了OpeCV的所有配置。下面就是配置VS2017.

2. 在VS2017中配置OpenCV

打开VS2017, 之后创建一个项目

在新建项目对话框中，选择空项目，修改名称和存放位置，点击确定

创建好项目后，在右侧的属性管理器窗口，右键点击创建项目，点击属性进行设置

此时可以直接跳转到下面的属性页配置窗口

或者打开项目的 属性管理器，本人是在Debug x64下配置。通过菜单 “视图” -> “其它窗口” -> "属性管理器"

下一步，在打开的属性管理器的"Debug | x64" 右键，弹出的菜单选择 属性

此种操作也可以跳转到下面的属性页的配置窗口

下一步添加包含目录，首先修改 包含目录，选中以后点击编辑
VC++ 目录 -> 包含目录-> 编辑

单击文件夹标志新建，然后选择目录

依次添加如下图所示的三个变量（即之前解压好的OpenCV路径下的build文件夹），单击确定

• D:\Program Files\opencv\build\include
• D:\Program Files\opencv\build\include\opencv
• D:\Program Files\opencv\build\include\opencv2
  

下一步，重复本过程，为库目录添加如下变量（即之前解压好的OpenCV路径下的，运行位数下的lib）单击确定 。VC++ 目录 -> 库目录 -> 编辑。

• D:\Program Files\opencv\build\x64\vc15\lib

• 
  
  下一步， 添加依赖项，修改附加依赖项，平台依旧选择X64，添加一下变量（手动输入或者粘贴）opencv_world341d.lib，单击确定。
  链接器 -> 输入 -> 附加依赖项
  
  手动敲入 opencv_world341d.lib
  
  注意:

• 341对应OpenCV3.4.1。如果安装的OpenCV版本不是3.4.1,请去网上找到对应自己的版本或者看安装的文件 opencv-3.4.1-vc14_vc15.exe （opencv-后面的就是版本)进行修改。

• 版本后面的d代表Debug模式，如果是Release模式要去掉d。依个人情况选择Debug模式或者Release模式。

到此，opencv3.4.1与vs2017开发环境已配置成功。最后新建一个项目，测试是否配置成功。对 源文件 右键，添加->新建项

输入如下代码进行测试即可！