Ubuntu 20.04下配置VSCode以支持OpenCV庫開發
- 1. 安裝OpenCV庫
- 安裝OpenCV(推薦使用APT安裝)
- 或者從源碼安裝OpenCV(可選)
- 2. 安裝VSCode的C++擴展
- 3. 配置`c_cpp_properties.json`
- 4. 編寫代碼并測試
- 5. 配置`tasks.json`(編譯OpenCV程序)
- 6. 運行程序
- 7. 安裝其他依賴(可選)
- 8. 使用CMake(可選)
- 總結
在VSCode中配置OpenCV需要確保OpenCV庫已正確安裝,并在VSCode中配置相關路徑和編譯選項。以下是詳細步驟:
1. 安裝OpenCV庫
在Ubuntu 20.04上,可以通過以下命令安裝OpenCV庫:
安裝OpenCV(推薦使用APT安裝)
sudo apt update
sudo apt install libopencv-dev
安裝完成后,OpenCV庫的頭文件和庫文件會分別存放在/usr/include/opencv4
和/usr/lib/x86_64-linux-gnu
目錄下。
或者從源碼安裝OpenCV(可選)
如果需要最新版本的OpenCV,可以從源碼編譯安裝。具體步驟可以參考OpenCV官方文檔。
2. 安裝VSCode的C++擴展
確保VSCode已安裝C/C++擴展:
- 打開VSCode。
- 進入擴展市場(Ctrl+Shift+X)。
- 搜索“C/C++”并安裝Microsoft提供的C/C++擴展。
3. 配置c_cpp_properties.json
為了讓VSCode正確識別OpenCV庫的頭文件,需要配置c_cpp_properties.json
文件:
- 打開VSCode,進入你的C++項目。
- 按下
Ctrl+Shift+P
,輸入“C/C++: Edit Configurations (UI)”并選擇。 - 在打開的界面中,找到“Include Path”設置。
- 添加OpenCV庫的頭文件路徑(例如
/usr/include/opencv4
)。
或者,可以直接編輯.vscode/c_cpp_properties.json
文件,內容如下:
{"configurations": [{"name": "Linux","includePath": ["${workspaceFolder}/**","/usr/include/opencv4" // OpenCV頭文件路徑],"defines": [],"compilerPath": "/usr/bin/g++","cStandard": "c11","cppStandard": "c++17","intelliSenseMode": "gcc-x64"}],"version": 4
}
4. 編寫代碼并測試
創建一個簡單的C++文件(如main.cpp
),測試OpenCV庫是否配置成功:
#include <opencv2/opencv.hpp>
#include <iostream>int main() {cv::Mat image = cv::imread("test.jpg"); // 讀取圖片if (image.empty()) {std::cerr << "Could not open or find the image!" << std::endl;return -1;}cv::imshow("Display window", image); // 顯示圖片cv::waitKey(0); // 等待按鍵return 0;
}
5. 配置tasks.json
(編譯OpenCV程序)
為了編譯OpenCV程序,需要配置tasks.json
文件:
- 打開VSCode,按下
Ctrl+Shift+P
,輸入“Tasks: Configure Task”并選擇。 - 選擇“Create tasks.json file from template” -> “Others”。
- 編輯生成的
tasks.json
文件,內容如下:
{"version": "2.0.0","tasks": [{"label": "build","type": "shell","command": "g++","args": ["-std=c++17","-I/usr/include/opencv4", // OpenCV頭文件路徑"${file}","-o","${fileDirname}/${fileBasenameNoExtension}","-lopencv_core", // 鏈接OpenCV庫"-lopencv_imgcodecs","-lopencv_highgui"],"group": {"kind": "build","isDefault": true},"problemMatcher": ["$gcc"],"presentation": {"reveal": "always"}}]
}
- 保存后,按下
Ctrl+Shift+B
即可編譯當前文件。
6. 運行程序
編譯成功后,在終端中運行生成的可執行文件:
./main
如果程序能夠正確顯示圖片(如test.jpg
),說明OpenCV庫配置成功。
7. 安裝其他依賴(可選)
如果編譯時提示缺少其他依賴庫,可以通過以下命令安裝:
sudo apt install build-essential cmake libgtk2.0-dev pkg-config
8. 使用CMake(可選)
如果你的項目使用CMake管理,可以創建一個CMakeLists.txt
文件,內容如下:
cmake_minimum_required(VERSION 3.10)
project(OpenCVTest)find_package(OpenCV REQUIRED)add_executable(main main.cpp)
target_link_libraries(main ${OpenCV_LIBS})
然后在VSCode中配置CMake工具:
- 安裝CMake擴展(搜索“CMake Tools”并安裝)。
- 打開項目文件夾,VSCode會自動檢測
CMakeLists.txt
并生成構建配置。
總結
通過以上步驟,你可以在VSCode中成功配置OpenCV庫,并編寫、編譯和運行使用OpenCV的C++代碼。關鍵步驟包括:
- 安裝OpenCV庫。
- 配置
c_cpp_properties.json
以包含OpenCV頭文件路徑。 - 配置
tasks.json
以支持編譯和鏈接OpenCV庫。
如果遇到問題,可以檢查OpenCV庫的安裝路徑是否正確,并確保所有依賴庫已安裝。