Ubuntu 20.04下配置VSCode以支持OpenCV库开发
在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库的安装路径是否正确,并确保所有依赖库已安装。