OpenCV 開發環境配置全攻略 (Windows + Visual Studio 2015/2019/2022)

前言

OpenCV (Open Source Computer Vision Library) 是計算機視覺領域最流行的開源庫。本文詳細記錄在 Windows 上配置 OpenCV 3.x/4.x 與 Visual Studio 的完整步驟，適用於 VS2015 及更新版本。

1. 下載與安裝

1. 訪問 OpenCV 官網 下載 Windows 版安裝包（如 opencv-4.8.0-windows.exe）。
2. 雙擊運行，實際為自解壓，選擇目錄（如 D:\OpenCV）。解壓後得到 build、sources 兩目錄。

2. 環境變量配置

右鍵「此電腦」→ 屬性 → 高級系統設置 → 環境變量 → 系統變量 Path → 編輯 → 新增：

D:\OpenCV\build\x64\vc15\bin   (VS2017)
D:\OpenCV\build\x64\vc16\bin   (VS2019/2022)

注意：OpenCV 4.x 不再提供 32 位預編譯庫，請直接使用 x64。修改後需重啟 VS 或電腦生效。

3. Visual Studio 項目屬性配置

建議使用「屬性管理器」創建可復用的 .props 文件，一次配置，多項目共享。

步驟

1. 新建空白 C++ 控制台項目。
2. 視圖 → 其他窗口 → 屬性管理器。
3. 右鍵「Debug | x64」→ 添加新項目屬性表 → 命名為 OpenCV.props。
4. 雙擊該 .props 文件，依次設置：

VC++ 目錄 → 包含目錄

D:\OpenCV\build\include
D:\OpenCV\build\include\opencv2

VC++ 目錄 → 庫目錄

D:\OpenCV\build\x64\vc15\lib   (對應 VS 版本)

鏈接器 → 輸入 → 附加依賴項

OpenCV 4.x 僅有兩個庫文件：

• Debug: opencv_world480d.lib
• Release: opencv_world480.lib

分別在 Debug/Release 配置下添加對應庫。

4. 驗證測試

新建 Main.cpp：

#include <opencv2/opencv.hpp>
#include <iostream>
using namespace cv;
using namespace std;

int main() {
    Mat img = imread("test.jpg");
    if (img.empty()) {
        cerr << "無法讀取圖片，請確認路徑" << endl;
        return -1;
    }
    namedWindow("OpenCV Test", WINDOW_AUTOSIZE);
    imshow("OpenCV Test", img);
    waitKey(0);
    return 0;
}

將測試圖片放在項目目錄（與 .vcxproj 同級）或使用絕對路徑。設置平台為 x64，按 F5 運行，應彈出圖片窗口。

5. 常見問題排查

6. 進階：CMake 管理 (推薦)

大型項目建議使用 CMake 自動查找 OpenCV：

find_package(OpenCV REQUIRED)
target_link_libraries(MyApp ${OpenCV_LIBS})

跨平台、跨 IDE，避免手動配置差異。

總結

配置核心三步：安裝 → Path 添加 bin → VS 項目配置 Include/Lib/Linker。掌握屬性表可大幅提升效率。遇到問題優先檢查 x64/VC 版本匹配與 Debug/Release 庫對應。