【OpenCV入门教程之一】安装OpenCV：OpenCV 3.0、OpenCV 2.4.8、OpenCV 2.4.9 +VS 开发环境配置

忘是亡心i 2022-05-27 01:27 717阅读 0赞

本系列文章由@浅墨\_毛星云 出品，转载请注明出处。

文章链接： [http://blog.csdn.net/poem\_qianmo/article/details/19809337][http_blog.csdn.net_poem_qianmo_article_details_19809337]

作者：毛星云（浅墨） 微博：[http://weibo.com/u/1723155442][http_weibo.com_u_1723155442]  
邮箱： happylifemxy@163.com  
知乎：[http://www.zhihu.com/people/mao-xing-yun][http_www.zhihu.com_people_mao-xing-yun]  
写作当前博文时配套使用的OpenCV版本： 2.4.8、2.4.9、3.0

（ 2014年4月28更新OpenCV 2.4.9的配置。  
2014年9月12更新OpenCV 3.0的配置  
2014年9月12日本文第6次修订完毕）

OpenCV2.4.9和2.4.8的配置几乎一样，唯一的区别在下文中的第五步，链接库的配置，把对应的248改成249即可。  
OpenCV 3.0配置更是被简化了。和2.4.8、2.4.9的区别就是下文第五步，链接库的配置，只用添加  
opencv\_ts300d.lib、opencv\_world300d.lib（debug版本的库）  
或opencv\_ts300.lib、opencv\_world300.lib（release版本的库）即可。

————————————————————————浅墨于2014年9月12日注

因为读研期间的研究方向是图像处理，所以浅墨这段时间闭门研究了很多OpenCV和图像处理相关的知识与内容。眼看自己积累到一定的程度了，于是决定开始开设这个OpenCV系列专栏，总结自己所学，也分享知识给大家。

好了，这篇文章作为OpenCV的启程篇，自然少不了先系统地介绍OpenCV开发环境的配置。

浅墨前后经历过OpenCV 2.4.6，OpenCV 2.4.7，OpenCV 2.4.8这三个版本的配置，有时候还要涉及到三个版本之间的转换，所以还是对OpenCV的配置有一定的理解的，希望自己的一点拙见能帮到大家。

还是先放出待会儿的测试用图（如果要另存为这张图并配合文章后面给出的代码进行测试，注意后缀名要为jpg，而不是jpeg或其他）：

![无][SouthEast]

那么，开始吧。

**1.下载和安装OpenCV SDK**

VS2010不用说，肯定都安装了吧。来说说当前最新的OpenCV版本2.4.8（2014年2月24日），2.4.9 （2014年4月）的下载和安装。与其说是安装，不如叫解压更加合适，因为我们下载的exe安装文件就是一个自解压程序而已。

![无][SouthEast 1]

在官网：[http://opencv.org/][http_opencv.org]上找到OpenCV windows版下载下来。![无][SouthEast 2]

下载完后得到文件OpenCV2.4.X，双击后会提示解压到某个地方，推荐放到D:\\Program Files\\下，比如D:\\Program Files，（因为OpenCV项目文件打包的时候，根目录就是opencv，所以我们不需要额外的新建一个名为opencv的文件夹，然后再解压，那是多此一举的事情）然后点击Extract按钮。

![无][SouthEast 3]

等一段时间，OpenCV2.4.8近3个多G的文件就解压到了D:\\Program Files下。

![无][SouthEast 4]

其中，build里面是使用OpenCV相关的文件，我们如果只是使用OpenCV的话呢，就只用管build里面的内容。下面的sources文件夹你嫌烦，你嫌占硬盘空间，完全可以删掉。但是需要注意的是，官方示例集，也就是samples文件夹里面的示例程序，在sources文件夹里面躺着呢，所以，如果真是要删的话，还是想清楚哦。

【OpenCV入门教程之七】 玩转OpenCV源代码：生成OpenCV工程解决方案与OpenCV源码编译

**2.配置环境变量**

这步的配置方法如下:  
【计算机】->【（右键）属性】->【高级系统设置】->【高级（标签）】->【环境变量】->“双击”系统变量中的PATH->在变量值里面添加相应的路径。如图：

<1>  
![无][SouthEast 5]

<2>  
![无][SouthEast 6]

<3>  
![无][SouthEast 7]

<4>  
![无][SouthEast 8]

<5>  
![无][SouthEast 9]

对于32位系统，就添加：  
”;…… opencv\\build\\x86\\vc10\\bin”（和之前的就有有的环境变量用英文的分号“;”进行分隔）

而对于64位系统，可以两个都添加上：  
”;…… opencv\\build\\x86\\vc10\\bin”  
和”…… opencv\\build\\x64\\vc10\\bin”，  
这样，到时候才可以在编译器Win32和X64中来回切换都吃得开，游刃有余~

例如，浅墨的就是  
D:\\ProgramFiles\\opencv\\build\\x64\\vc10\\bin;D:\\Program Files\\opencv\\build\\x86\\vc10\\bin

PS:有童鞋亲测说64位系统也只需添加”…… opencv\\build\\x86\\vc10\\bin”即可，大家不妨一试。

注：变量值实际为bin文件夹的路径；D表示OpenCV安装于D盘；X64表示运行系统环境位64位系统，若安装于32位系统，应为X86；vc10表示编译环境为Microsoft Visual Studio 2010；变量添加完成后最好注销系统，才会生效。

**3.工程包含（include）目录的配置**

之前看过的好多博文都说“每次新建工程都要重新配置”，其实不用这样麻烦的。  
首先是在Visual Studio里面新建一个控制台应用程序，最好是勾好空项目那个勾。  
（考虑到看这篇博文的童鞋很少接触vs，那么浅墨在这里将过程详细截图出来——浅墨2014年6月11日注）  
<1>打开visual studio，新建win32控制台项目,取个名字，比如叫test1，然后选好路径，点确定.  
![无][SouthEast 10]

<2>点一次“下一步”。  
![无][SouthEast 11]

<3>勾上空项目那个勾。  
![无][SouthEast 12]

<4>接着在解决方案资源管理器的【源文件】处右击->添加->新建项，准备在工程中新建一个cpp源文件。  
![无][SouthEast 13]

![无][SouthEast 14]

<5>选定C++源文件，取个名字，比如叫“main”，然后点【添加】，那么，一个新的cpp文件就添加到了工程中。

<6>看过浅墨之前DirectX配置的相关博文的朋友们应该都知道，有一招叫属性管理器。在属性管理器中进行一次配置，就相当于进行了通用的配置过程，以后新建的工程就不用再额外的进行重新配置了。  
在菜单栏里面点<视图>–<属性管理器>，那么就会在visual studio中多出一个属性管理器工作区来。

![无][SouthEast 15]

<7>在新出现的“属性管理器”工作区中，点击项目->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（右键属性，或者双击）即可打开属性页面。

![无][SouthEast 16]

<8>打开属性页面后，就是一番配置了。首先是在  
【通用属性】 ->【VC++目录】 ->【包含目录】中  
![无][SouthEast 17]

添加上  
D:\\Program Files\\opencv\\build\\include  
D:\\Program Files\\opencv\\build\\include\\opencv  
D:\\Program Files\\opencv\\build\\include\\opencv2 这三个目录。

![无][SouthEast 18]

当然，这是之前把OpenCV解压到D:\\Program Files\\下的情况。实际的路径还要看你自己把OpenCV解压到了哪个目录下，根据你的实际情况来调节。

**4.工程库（lib）目录的配置**

其实这步和上一步差不多，属性管理器”工作区中，点击项目->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（反键属性，或者双击）打开属性页面。  
接着上步，就是在【通用属性】 ->【VC++目录】 ->【库目录】中，

![无][SouthEast 19]

添加上D:\\Program Files\\opencv\\build\\x86\\vc10\\lib这个路径。（最好不要复制粘贴浅墨给出的路径，而是自己去预览里面指定出来，这样会准确得多）

这里选择x86还是x64是一个常常令人困惑的问题。当然，对于32位操作系统，铁定就是选x86了。  
如果是64位操作系统，很多童鞋会想当然自作聪明地选择x64，其实不然。正确的理解是这样的：

不管你是32位还是64位操作系统，只用管你用win32编译器还是X64编译器。  
其实配置选择什么跟64位还是32位系统没有直接的关系，而是在于你在编译你的程序的时候是使用那个编译器。  
![无][SouthEast 20]

编译器选的是win32，就用x86  
编译器选的是X64，就用X64。不过一般情况下，都是用的win32的X86编译器。所以，无论32还是64位操作系统，配置文件最好都选择x86版的

另外，这里的vc10表示vs2010，如果是其他版本的visual studio，稍微要微调一下。  
感谢JJBomb 童鞋，这里我们补充完整：vc8 = Visual Studio 2005，vc9 = Visual Studio 2008，vc10 = Visual Studio 2010，vc11 = Visual Studio 2012，vc12 = Visual Studio 2013。

**5.链接库的配置**

依然是“属性管理器”工作区中，点击项目->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（反键属性，或者双击）即可打开属性页面。【通用属性】 ->【链接器】->【输入】->【附加的依赖项】

![无][SouthEast 21]

对于【OpenCV2.4.8】，添加如下248版本的lib（这样的lib顺序是：19个带d的debug版的lib写在前面，19个不带d的release版的lib写在后面）：  
opencv\_ml248d.lib  
opencv\_calib3d248d.lib  
opencv\_contrib248d.lib  
opencv\_core248d.lib  
opencv\_features2d248d.lib  
opencv\_flann248d.lib  
opencv\_gpu248d.lib  
opencv\_highgui248d.lib  
opencv\_imgproc248d.lib  
opencv\_legacy248d.lib  
opencv\_objdetect248d.lib  
opencv\_ts248d.lib  
opencv\_video248d.lib  
opencv\_nonfree248d.lib  
opencv\_ocl248d.lib  
opencv\_photo248d.lib  
opencv\_stitching248d.lib  
opencv\_superres248d.lib  
opencv\_videostab248d.lib

opencv\_objdetect248.lib  
opencv\_ts248.lib  
opencv\_video248.lib  
opencv\_nonfree248.lib  
opencv\_ocl248.lib  
opencv\_photo248.lib  
opencv\_stitching248.lib  
opencv\_superres248.lib  
opencv\_videostab248.lib  
opencv\_calib3d248.lib  
opencv\_contrib248.lib  
opencv\_core248.lib  
opencv\_features2d248.lib  
opencv\_flann248.lib  
opencv\_gpu248.lib  
opencv\_highgui248.lib  
opencv\_imgproc248.lib  
opencv\_legacy248.lib  
opencv\_ml248.lib

对于【OpenCV2.4.9】，添加如下249版本的lib（这样的lib顺序是：19个带d的debug版的lib写在前面，19个不带d的release版的lib写在后面）：

opencv\_ml249d.lib  
opencv\_calib3d249d.lib  
opencv\_contrib249d.lib  
opencv\_core249d.lib  
opencv\_features2d249d.lib  
opencv\_flann249d.lib  
opencv\_gpu249d.lib  
opencv\_highgui249d.lib  
opencv\_imgproc249d.lib  
opencv\_legacy249d.lib  
opencv\_objdetect249d.lib  
opencv\_ts249d.lib  
opencv\_video249d.lib  
opencv\_nonfree249d.lib  
opencv\_ocl249d.lib  
opencv\_photo249d.lib  
opencv\_stitching249d.lib  
opencv\_superres249d.lib  
opencv\_videostab249d.lib

opencv\_objdetect249.lib  
opencv\_ts249.lib  
opencv\_video249.lib  
opencv\_nonfree249.lib  
opencv\_ocl249.lib  
opencv\_photo249.lib  
opencv\_stitching249.lib  
opencv\_superres249.lib  
opencv\_videostab249.lib  
opencv\_calib3d249.lib  
opencv\_contrib249.lib  
opencv\_core249.lib  
opencv\_features2d249.lib  
opencv\_flann249.lib  
opencv\_gpu249.lib  
opencv\_highgui249.lib  
opencv\_imgproc249.lib  
opencv\_legacy249.lib  
opencv\_ml249.lib

![无][SouthEast 22]

需要注意的是，所粘贴内容即为之前我们解压的OpencV目录D:\\opencv\\build\\x86\\vc10\\lib下所有lib库文件的名字；其中的248代表我们的OpenCV版本为2.4.8，若是其他版本的配置则在这里要进行相应的更改，比如说2.4.6版的OpenCV，那么这里的opencv\_calib3d248d.lib就要改成opencv\_calib3d246d.lib了.  
Debug文件库名有d结尾，Release没有，如 opencv\_ts248d.lib（debug版本的lib）和opencv\_ts248.lib（release版本的lib）  
不过我一般是在这里把带d和不带d的统统写在这里，因为这里是以后创建所有工程时都会继承的公共属性。

对于【OpenCV 3.0】，添加3.0版本的lib，新版的lib非常简单。想用debug版本的库，添加  
opencv\_ts300d.lib  
opencv\_world300d.lib 这两个库即可。  
而想用release版本的库，添加  
opencv\_ts300.lib  
opencv\_world300.lib即可。

其实，对已经发行和未来即将发布的新版OpenCV，只需看opencv\\build\\x86\\vc10\\lib下的库是哪几个，添加成依赖项就可以了。

**另外注意**：按照如上的这种方式来配置，也许会出现debug下可以运行但是release下不能运行的情况（因为字符串读取问题引起的诸如图片载入不了，报指针越界，内存错误等等），这算是OpenCV自2.4.1以来的一个bug。

**解决方案**：想在release模式下运行出程序结果，在工程的release模式下，将不带d的lib（全部是19个）添加到【项目】->【属性】（注意这样打开的是当前工程的属性页，我们只需在这里将release版（即不带d）的相关lib添加进去）->【配置属性】->【链接器】->【输入】->【附加的依赖项】下即可。

类似错误如图：  
![无][SouthEast 23]

**6.在Windows文件夹下加入OpenCV动态链接库**

PS：经过 hellofuturecyj 同学提醒，如果配置环境变量那步配置准确，且配置之后经过重启，就没有进行这步配置的必要了。即做完上面第五步的配置，重启一次，就可以直接跳到第七步，进行测试，看出不出图。  
当然，如果需不重启而马上来看配置的结果，就可以试试这里的方式。

这一步是各种介绍OpenCV的配置的相关博文中都没写出来的。根据这些博文配置出来的环境，在运行基于OpenCV的程序的时候，往往会得到这样类似的结果：

![无][SouthEast 24]

这种问题最简单粗暴的方法，是把相关的dll都拷贝到Windows操作系统的目录下。如果你的Windows安装在C盘，那么路径就是c:\\Windows\\System32。按照之前我的OpenCV的存放环境，这些dll存放在  
D:\\Program Files\\opencv\\build\\x86\\vc10\\bin目录下。

![无][SouthEast 25]

到这个目录下，【Alt+A】全选，【Alt+C】拷贝，然后转到c:\\Windows\\System32下面，【Alt+V】复制，简单粗暴地就完成了。  
PS:对于Windows 8，则要放在要在SysWOW64文件夹中。

恩，环境配置大功告成，我们来测试一下成果吧~

**7.最终的测试**

就用载入并显示一张图片到窗口的程序，用于我们的配置测试吧。  
新建一个空项目的控制台应用程序，新建一个cpp文件，然后粘贴如下代码：

#include<iostream> 
    #include <opencv2/core/core.hpp> 
    #include <opencv2/highgui/highgui.hpp> 
    
    
    using namespace cv;  
    
    
    int main()  
    {  
        // 读入一张图片（游戏原画） 
        Mat img=imread("pic.jpg");  
        // 创建一个名为 "游戏原画"窗口 
        namedWindow("游戏原画");  
        // 在窗口中显示游戏原画 
        imshow("游戏原画",img);  
        // 等待6000 ms后窗口自动关闭 
        waitKey(6000);  
    }

放置一张名为pic.jpg的图片到工程目录中，然后点击“运行“按钮，如果配置成功，就不会报错，得到预想的运行结果：  
![无][SouthEast 26]

**7.可能遇到的问题和解决方案**  
1. 找不到core.h  
出现这个问题是因为include的时候粗心大意了。  
如果你的版本是2.4.6。在这个版本下，opencv根文件夹下面就有个include，但我们配置的时候如果包含的是他就坑爹了。  
正确的应该填build里面的那个include。

2.无法解析的外部命令  
这个问题其实上面有过解释了，不管你是32位还是64位操作系统，只用管你用win32编译器还是X64 编译器。  
其实配置选择什么跟64位还是32位系统没有直接的关系，而是在于你在编译你的程序的时候是使用那个编译器。

编译器是win32，就用x86  
编译器是X64，就用X64。不过一般情况下，都是用的win32的X86编译器。所以，  
无论32还是 64位操作系统，配置文件最好都选择x86版的。

3.关于形如–error LNK2005:xxx 已经在 msvcrtd.lib ( MSVCR90D.dll ) 中定义  
出现这个问题，把静态库不包含就行了。

4.应用程序无法正常启动0xc000007b  
Lib包含的问题。也许你同时包含了X86和X64的，或者包含出错错了。或者是对于windows 8 64位，dll要放在和System32文件夹同级的SysWOW64文件夹中。

5.明明图片路径是对的，却载入不进去图片，提示指针越界，有未经处理的异常  
类似错误如图：

![无][SouthEast 27]

这算是opencv的一个bug，工程属性里面关于带d和不带d的lib文件的附加依赖项的问题，就算配置好了每次想debug和release下都运行还得手动在工程属性里面加。当得到这样的错误时，可以把调试方式改一改，debug和release互换：

![无][SouthEast 28]

或者打开当前工程（注意是当前工程的属性页，不是通用属性页）的属性页，debug或者release哪个报错，就把对应的带d或不带d的lib添加到【“当前”工程属性】->【链接器】->【输入】->【附加的依赖项】下即可。

关于问题五的另一种错法：图片后缀问题  
昨天晚上一个学弟和大家一样在参考这篇文章配置OpenCV环境，弄了一下午一直报这个错误。最后浅墨给他看了下，发现是图片后缀的问题，在这里更新一下，以免有童鞋是因为这个问题而一直得不出结果。确保你载入的图片是和代码中imread的路径、名称、后缀是一模一样的。例如，学弟遇到的问题就是，在xp系统下面，没有显示后缀名，下了浅墨在文章末尾给出的配置参考示例程序，估计是xp系统默认会把jpg当做jpeg对待，然后他在代码中imread的是“1.jpg”，硬是报错。我给他看的时候，在文件夹选项中调出文件后缀名，发现在win7下面给大家准备的名为“1.jpg”的文件，在xp下面变成了“1.jpeg”。然后浅墨将学弟代码中的“1.jpg”改成“1.jpeg”，立马出结果。或许这就是一部分朋友们调不出结果的另一种原因吧。

6.无法打开文件“opencv\_ml249d.lib”系列的错误

关于LINK : fatal error LNK1104: 无法打开文件“opencv\_ml249d.lib”，在评论区和大家给浅墨发的邮件中是普遍的一个错误。

PS:jzh258fits同学提出的一个新的解决方法是：项目->属性管理器->Debug|Win32->Microsoft.Cpp.Win32.userDirectories中的属性页面->连接器->常规里面的附加库目录中加入相应的lib文件目录。

这个错误主要是因为包含的库目录中，和包含的附加依赖项不能相互对应照成的。

也许是“opencv\_ml249d.lib“多加了一个空格，成了”opencv\_ml249d. lib“，就会报错。  
遇到这个问题，检查三个方面：

1.检查第四步”4.工程库（lib）目录的配置“库目录中的路径是否准确。  
2.检查第五步”5.链接库的配置“中“附加依赖项”的格式有没有问题，有没有多空格，版本号248,249什么的有没有问题，有没有多一个空格，少一个点什么的。  
3.第二步环境变量的配置是否准确。

好了，OpenCV的配置大概就是这些。  
下篇文章见 ：）

![无][SouthEast 29]

[http_blog.csdn.net_poem_qianmo_article_details_19809337]: http://blog.csdn.net/poem_qianmo/article/details/19809337
[http_weibo.com_u_1723155442]: http://weibo.com/u/1723155442
[http_www.zhihu.com_people_mao-xing-yun]: http://www.zhihu.com/people/mao-xing-yun
[SouthEast]: /images/20220527/c4f1a8d1cd3044378bf2b183f5478ad5.png
[SouthEast 1]: /images/20220527/447a900f4ff24cbdb7b6e816ce068697.png
[http_opencv.org]: http://opencv.org/
[SouthEast 2]: /images/20220527/f58e4b96aad444de89ecbec0a4ce743b.png
[SouthEast 3]: /images/20220527/8bed292edb334bcd90f253d64883978d.png
[SouthEast 4]: /images/20220527/8ccb1697cda44e54b815a6aa7cea79f0.png
[SouthEast 5]: /images/20220527/349edf9080ea454f86d38e56d8df0407.png
[SouthEast 6]: /images/20220527/f99af3439e9c4fa19ec6bb5063cdbbec.png
[SouthEast 7]: /images/20220527/a0f02d9445bf4084a8e98344982877e7.png
[SouthEast 8]: /images/20220527/75dc48a061174b4d8970c3eaa77e1097.png
[SouthEast 9]: /images/20220527/506b2138db2143b89fc234c16fef03d6.png
[SouthEast 10]: /images/20220527/bd569162e2264d239eb088f562755619.png
[SouthEast 11]: /images/20220527/9a0d6d6cf0034d78b6961d9cd2944d72.png
[SouthEast 12]: /images/20220527/bf01ba4a23844cc0bb5339260aceecac.png
[SouthEast 13]: /images/20220527/69599c5e18824d86b1eccd3258d61220.png
[SouthEast 14]: /images/20220527/caf5c15f42c1467f82555f3f581c005c.png
[SouthEast 15]: /images/20220527/563c501685e243cd9272d109d3f18175.png
[SouthEast 16]: /images/20220527/93ef6a806f404b3a8dfc4db7addba8fc.png
[SouthEast 17]: /images/20220527/d7c05ced277f4c63ac8251a05aa24c0e.png
[SouthEast 18]: /images/20220527/ddaf189ac738412cba910213d2bd8179.png
[SouthEast 19]: /images/20220527/34533ff9c9074738987401c508853fd8.png
[SouthEast 20]: /images/20220527/14c152900e1e4e8eb556443a1e94f9b6.png
[SouthEast 21]: /images/20220527/9db3066b970448bbbb01becaf24a8c16.png
[SouthEast 22]: /images/20220527/a395f5b04dbd4817b3e21f7eff22d653.png
[SouthEast 23]: /images/20220527/00604bf771f34bc484448f83d61a6f87.png
[SouthEast 24]: /images/20220527/83f9e6e752f74bc5a49cb338f9cabb7d.png
[SouthEast 25]: /images/20220527/4acd96cd68384f2f8b7f21af393bdd02.png
[SouthEast 26]: /images/20220527/3375297e38f64dd8a388ef845edbb42d.png
[SouthEast 27]: /images/20220527/6e6e0ce723fe406a8df4d38f28f9a9ea.png
[SouthEast 28]: /images/20220527/a3f6a61f06da4b2db1722f75a3660780.png
[SouthEast 29]: /images/20220527/a2f1efadfaa5412cabc2cca8415b3195.png