0. 實驗環境

本教程大多是在VS2010、Opencv2.4.8的環境下進行的，但是筆者親自實驗，發現過程大多大同小異，只是VS對應的OpenCV版本可能不同，這在4.工程庫（lib）目錄的配置中有詳細介紹。

1.下載和安裝OpenCV SDK

VS2010不用說，肯定都安裝了吧。來說說當前最新的OpenCV版本2.4.8（2014年2月24日），2.4.9 （2014年4月）的下載和安裝。與其說是安裝，不如叫解壓更加合適，因為我們下載的exe安裝檔案就是一個自解壓程式而已。

下載完後得到檔案OpenCV 2.4.X，雙擊後會提示解壓到某個地方，推薦放到D:\Program Files\下，比如D:\Program Files，（因為OpenCV專案檔案打包的時候，根目錄就是opencv，所以我們不需要額外的新建一個名為opencv的資料夾，然後再解壓，那是多此一舉的事情）然後點選Extract按鈕。

等一段時間，OpenCV2.4.8近3個多G的檔案就解壓到了D:\Program Files下。

其中，build裡面是使用OpenCV相關的檔案，我們如果只是使用OpenCV的話呢，就只用管build裡面的內容。下面的sources資料夾你嫌煩，你嫌佔硬碟空間，完全可以刪掉。但是需要注意的是，官方示例集，也就是samples資料夾裡面的示例程式，在sources資料夾裡面躺著呢，所以，如果真是要刪的話，還是想清楚哦。

2.配置環境變數

這步的配置方法如下:

【計算機】->【（右鍵）屬性】->【高階系統設定】->【高階（標籤）】->【環境變數】->“雙擊”系統變數中的PATH->在變數值裡面新增相應的路徑。如圖：

一般不需要重啟，若不行，先重啟VS，再重啟系統。

對於32位系統，就新增：

”;…… opencv\build\x86\vc10\bin”  （和之前的就有有的環境變數用英文的分號“;”進行分隔）

而對於64位系統，可以兩個都新增上：

”;…… opencv\build\x86\vc10\bin”
”…… opencv\build\x64\vc10\bin”，

這樣，到時候才可以在編譯器Win32和X64中來回切換都吃得開，遊刃有餘~

例如，淺墨的就是

D:\Program Files\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日注)

開啟visual studio，新建win32控制檯專案,取個名字，比如叫test1，然後選好路徑，點確定.

點一次“下一步”。

勾上空專案那個勾。

接著在解決方案資源管理器的【原始檔】處右擊->新增->新建項，準備在工程中新建一個cpp原始檔。

選定C++原始檔，取個名字，比如叫“main”，然後點【新增】，那麼，一個新的cpp檔案就新增到了工程中。

看過淺墨之前DirectX配置的相關博文的朋友們應該都知道，有一招叫屬性管理器。在屬性管理器中進行一次配置，就相當於進行了通用的配置過程，以後新建的工程就不用再額外的進行重新配置了。

在選單欄裡面點<檢視>–<屬性管理器>，那麼就會在visual studio中多出一個屬性管理器工作區來。

在新出現的“屬性管理器”工作區中，點選專案->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（右鍵屬性，或者雙擊）即可開啟屬性頁面。

開啟屬性頁面後，就是一番配置了。首先是在【通用屬性】 ->【VC++目錄】 ->【包含目錄】中

新增上下面三個目錄

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

注意，對於VS2015，不是下面的地方：

而是這裡：

當然，這是之前把OpenCV解壓到D:\Program Files\下的情況。實際的路徑還要看你自己把OpenCV解壓到了哪個目錄下，根據你的實際情況來調節。

4.工程庫（lib）目錄的配置

其實這步和上一步差不多，屬性管理器”工作區中，點選專案->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（反鍵屬性，或者雙擊）開啟屬性頁面。

接著上步，就是在【通用屬性】 ->【VC++目錄】 ->【庫目錄】中，

新增上D:\Program Files\opencv\build\x86\vc10\lib這個路徑。（最好不要複製貼上淺墨給出的路徑，而是自己去預覽裡面指定出來，這樣會準確得多）

這裡選擇x86還是x64是一個常常令人困惑的問題。當然，對於32位作業系統，鐵定就是選x86了。

如果是64位作業系統，很多童鞋會想當然自作聰明地選擇x64，其實不然。正確的理解是這樣的：

不管你是32位還是64位作業系統，只用管你用win32編譯器還是X64編譯器。

其實配置選擇什麼跟64位還是32位系統沒有直接的關係，而是在於你在編譯你的程式的時候是使用那個編譯器。

編譯器選的是win32，就用x86

編譯器選的是X64，就用X64。不過一般情況下，都是用的win32的X86編譯器。所以，無論32還是64位作業系統，配置檔案最好都選擇x86版的

另外，這裡的vc10表示vs2010，如果是其他版本的visual studio，稍微要微調一下。

感謝JJBomb 童鞋，這裡我們補充完整：

Visual Studio 6 ： vc6 
Visual Studio 2003 ： vc7 
Visual Studio 2005 ： vc8 
Visual Studio 2008 ： vc9 
Visual Studio 2010 ： vc10 
Visual Studio 2012 ： vc11 
Visual Studio 2013 ： vc12 
Visual Studio 2015 ： vc14 
Visual Studio 2017 ： vc15

opencv 對 VC版本 的支援情況

opencv 2.4.10 == vc10、vc11、vc12 
opencv 2.4.13 == vc11、vc12 
opencv 3.4.0 == vc11、vc12 
opencv 3.4.1 == vc14、vc15

5.連結庫的配置

依然是“屬性管理器”工作區中，點選專案->Debug|Win32->Microsoft.Cpp.Win32.userDirectories（反鍵屬性，或者雙擊）即可開啟屬性頁面。【通用屬性】 ->【連結器】->【輸入】->【附加的依賴項】

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

需要注意的是，所貼上內容即為之前我們解壓的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 2.4.13

opencv_calib3d2413d.lib
opencv_contrib2413d.lib
opencv_core2413d.lib
opencv_features2d2413d.lib
opencv_flann2413d.lib
opencv_gpu2413d.lib
opencv_highgui2413d.lib
opencv_imgproc2413d.lib
opencv_legacy2413d.lib
opencv_ml2413d.lib
opencv_nonfree2413d.lib
opencv_objdetect2413d.lib
opencv_ocl2413d.lib
opencv_photo2413d.lib
opencv_stitching2413d.lib
opencv_superres2413d.lib
opencv_ts2413d.lib
opencv_video2413d.lib
opencv_videostab2413d.lib

其實，對已經發行和未來即將釋出的新版OpenCV，只需看opencv\build\x86\vc10\lib下的庫是哪幾個，新增成依賴項就可以了。

6.在Windows資料夾下加入OpenCV動態連結庫

PS：經過 hellofuturecyj 同學提醒，如果配置環境變數那步配置準確，且配置之後經過重啟，就沒有進行這步配置的必要了。即做完上面第五步的配置，重啟一次，就可以直接跳到第七步，進行測試，看出不出圖。

當然，如果需不重啟而馬上來看配置的結果，就可以試試這裡的方式。

這一步是各種介紹OpenCV的配置的相關博文中都沒寫出來的。根據這些博文配置出來的環境，在執行基於OpenCV的程式的時候，往往會得到這樣類似的結果：

這種問題最簡單粗暴的方法，是把相關的dll都拷貝到Windows作業系統的目錄下。如果你的Windows安裝在C盤，那麼路徑就是c:\Windows\System32。按照之前我的OpenCV的存放環境，這些dll存放在D:\Program Files\opencv\build\x86\vc10\bin目錄下。

到這個目錄下，【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);
}

8.可能遇到的問題和解決方案

呼，生活不可能是一帆風順的，我們的配置過程也是。淺墨在幾次的配置過程中，出現瞭如下的幾種典型問題，我相信你可能會出現，就在這裡集中列舉一下吧，希望能為大家解惑：

8.1 找不到core.h

出現這個問題是因為include的時候粗心大意了。

如果你的版本是2.4.6。在這個版本下，opencv根資料夾下面就有個include，但我們配置的時候如果包含的是他就坑爹了。

正確的應該填build裡面的那個include。

8.2 無法解析的外部命令

這個問題其實上面有過解釋了，不管你是32位還是64位作業系統，只用管你用win32編譯器還是X64 編譯器。

其實配置選擇什麼跟64位還是32位系統沒有直接的關係，而是在於你在編譯你的程式的時候是使用那個編譯器。

編譯器是win32，就用x86

編譯器是X64，就用X64。不過一般情況下，都是用的win32的X86編譯器。所以，

無論32還是 64位作業系統，配置檔案最好都選擇x86版的。

8.3 關於形如–error LNK2005:xxx 已經在 msvcrtd.lib ( MSVCR90D.dll ) 中定義

出現這個問題，把靜態庫不包含就行了。

8.4 應用程式無法正常啟動0xc000007b

Lib包含的問題。也許你同時包含了X86和X64的，或者包含出錯錯了（我同時包含了x86與x64解決了這個bug）。或者是對於windows 8 64位，dll要放在和System32資料夾同級的SysWOW64資料夾中。

5.明明圖片路徑是對的，卻載入不進去圖片，提示指標越界，有未經處理的異常

類似錯誤如圖：

這算是opencv的一個bug，工程屬性裡面關於帶d和不帶d的lib檔案的附加依賴項的問題，就算配置好了每次想debug和release下都執行還得手動在工程屬性裡面加。當得到這樣的錯誤時，可以把除錯方式改一改，debug和release互換：

或者開啟當前工程（注意是當前工程的屬性頁，不是通用屬性頁）的屬性頁，debug或者release哪個報錯，就把對應的帶d或不帶d的lib新增到【“當前”工程屬性】->【連結器】->【輸入】->【附加的依賴項】下即可。

關於問題五的另一種錯法：圖片字尾問題

昨天晚上一個學弟和大家一樣在參考這篇文章配置OpenCV環境，弄了一下午一直報這個錯誤。最後淺墨給他看了下，發現是圖片字尾的問題，在這裡更新一下，以免有童鞋是因為這個問題而一直得不出結果。確保你載入的圖片是和程式碼中imread的路徑、名稱、字尾是一模一樣的。例如，學弟遇到的問題就是，在xp系統下面，沒有顯示字尾名，下了淺墨在文章末尾給出的配置參考示例程式，估計是xp系統預設會把jpg當做jpeg對待，然後他在程式碼中imread的是“1.jpg”，硬是報錯。我給他看的時候，在資料夾選項中調出檔案字尾名，發現在win7下面給大家準備的名為“1.jpg”的檔案，在xp下面變成了“1.jpeg”。然後淺墨將學弟程式碼中的“1.jpg”改成“1.jpeg”，立馬出結果。或許這就是一部分朋友們調不出結果的另一種原因吧。

8.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“，就會報錯。 遇到這個問題，檢查三個方面：

• 檢查第四步”4.工程庫（lib）目錄的配置“庫目錄中的路徑是否準確。
• 檢查第五步”5.連結庫的配置“中“附加依賴項”的格式有沒有問題，有沒有多空格，版本號248,249什麼的有沒有問題，有沒有多一個空格，少一個點什麼的。
• 第二步環境變數的配置是否準確。

參考

One more thing

更多關於人工智慧、Python、C++、計算機等知識，歡迎訪問我的個人部落格進行交流， 點這裡~~