手把手教你用VScode在Ubuntu上跑通第一个OpenCV（C++）程序
·
从零开始：Ubuntu+VSCode搭建OpenCV C++开发环境全指南
1. 环境准备与工具安装
工欲善其事，必先利其器。在开始OpenCV C++开发之前，我们需要确保基础环境配置完善。Ubuntu作为Linux发行版中的佼佼者，为开发者提供了稳定高效的开发平台，而VSCode则是微软推出的轻量级但功能强大的代码编辑器，两者结合能为OpenCV开发提供良好的支持。
首先，我们需要安装必要的编译工具链。打开终端（Ctrl+Alt+T），执行以下命令更新软件源并安装基础编译工具：
sudo apt update
sudo apt install -y build-essential cmake git
接下来安装VSCode。虽然Ubuntu软件中心提供了安装选项，但建议通过官方源获取最新版本：
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/
sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'
sudo apt update
sudo apt install -y code
安装完成后，我们需要为C++开发安装必要的VSCode扩展：
- C/C++（微软官方提供）
- CMake Tools
- Code Runner
这些扩展可以通过VSCode左侧活动栏的扩展图标搜索安装，它们将提供代码补全、调试和构建支持。
2. OpenCV库的安装与验证
OpenCV作为计算机视觉领域的瑞士军刀，其安装过程需要特别注意版本兼容性。我们推荐从源码编译安装，这样可以确保获得最新特性并针对特定硬件进行优化。
首先安装OpenCV的依赖项：
sudo apt install -y libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
sudo apt install -y libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libdc1394-22-dev
然后下载OpenCV源码（这里以4.5.5版本为例）：
mkdir ~/opencv_build && cd ~/opencv_build
git clone https://github.com/opencv/opencv.git
git clone https://github.com/opencv/opencv_contrib.git
cd opencv
git checkout 4.5.5
cd ../opencv_contrib
git checkout 4.5.5
编译安装OpenCV（根据CPU核心数调整-j参数）：
cd ~/opencv_build/opencv
mkdir build && cd build
cmake -D CMAKE_BUILD_TYPE=RELEASE \
-D CMAKE_INSTALL_PREFIX=/usr/local \
-D OPENCV_EXTRA_MODULES_PATH=~/opencv_build/opencv_contrib/modules \
-D WITH_TBB=ON \
-D WITH_FFMPEG=ON \
-D OPENCV_GENERATE_PKGCONFIG=ON \
-D BUILD_EXAMPLES=OFF ..
make -j$(nproc)
sudo make install
安装完成后，验证OpenCV是否安装成功：
pkg-config --modversion opencv4
如果正确显示版本号，说明安装成功。还可以运行以下Python命令进行简单验证：
python3 -c "import cv2; print(cv2.__version__)"
3. VSCode工程配置详解
配置良好的开发环境能极大提升编码效率。在VSCode中，我们需要配置三个关键文件来支持OpenCV C++开发。
首先创建一个新文件夹作为工作区，用VSCode打开它。然后创建src文件夹存放源代码，创建.vscode文件夹存放配置文件。
3.1 c_cpp_properties.json配置
这个文件告诉VSCode在哪里查找头文件和库文件。按下Ctrl+Shift+P，输入"C/C++: Edit Configurations (JSON)"，会自动生成或打开该文件。配置示例如下：
{
"configurations": [
{
"name": "Linux",
"includePath": [
"${workspaceFolder}/**",
"/usr/local/include/opencv4",
"/usr/include"
],
"defines": [],
"compilerPath": "/usr/bin/g++",
"cStandard": "c17",
"cppStandard": "gnu++17",
"intelliSenseMode": "linux-gcc-x64",
"configurationProvider": "ms-vscode.cmake-tools"
}
],
"version": 4
}
3.2 tasks.json配置
这个文件定义了构建任务。创建或修改.vscode/tasks.json：
{
"version": "2.0.0",
"tasks": [
{
"type": "cppbuild",
"label": "C/C++: g++ build active file",
"command": "/usr/bin/g++",
"args": [
"-std=c++17",
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}",
"-I", "/usr/local/include/opencv4",
"-L", "/usr/local/lib",
"-lopencv_core",
"-lopencv_highgui",
"-lopencv_imgcodecs",
"-lopencv_imgproc",
"-lopencv_videoio"
],
"options": {
"cwd": "${fileDirname}"
},
"problemMatcher": ["$gcc"],
"group": {
"kind": "build",
"isDefault": true
},
"detail": "编译器: /usr/bin/g++"
}
]
}
3.3 launch.json配置
这个文件配置调试环境。创建或修改.vscode/launch.json：
{
"version": "0.2.0",
"configurations": [
{
"name": "g++ - 生成和调试活动文件",
"type": "cppdbg",
"request": "launch",
"program": "${fileDirname}/${fileBasenameNoExtension}",
"args": [],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"externalConsole": false,
"MIMode": "gdb",
"setupCommands": [
{
"description": "为 gdb 启用整齐打印",
"text": "-enable-pretty-printing",
"ignoreFailures": true
}
],
"preLaunchTask": "C/C++: g++ build active file",
"miDebuggerPath": "/usr/bin/gdb"
}
]
}
4. 第一个OpenCV程序的创建与调试
现在，让我们创建一个简单的OpenCV程序来验证环境配置是否正确。在src文件夹中创建display_image.cpp文件：
#include <opencv2/opencv.hpp>
#include <iostream>
using namespace cv;
using namespace std;
int main(int argc, char** argv) {
if (argc != 2) {
cout << "用法: " << argv[0] << " <图片路径>" << endl;
return -1;
}
Mat image = imread(argv[1], IMREAD_COLOR);
if (image.empty()) {
cout << "无法加载图片: " << argv[1] << endl;
return -1;
}
namedWindow("显示图片", WINDOW_AUTOSIZE);
imshow("显示图片", image);
waitKey(0);
destroyAllWindows();
return 0;
}
要运行这个程序，你需要准备一张测试图片放在项目文件夹中。然后可以通过以下几种方式运行：
-
使用VSCode内置终端：
g++ src/display_image.cpp -o bin/display_image \ -I /usr/local/include/opencv4 \ -L /usr/local/lib \ -lopencv_core -lopencv_highgui -lopencv_imgcodecs ./bin/display_image your_image.jpg -
使用VSCode任务：
- 按下Ctrl+Shift+B构建项目
- 在终端中运行生成的可执行文件
-
使用调试功能：
- 在main函数设置断点
- 按下F5启动调试
- 在调试控制台输入参数（如图片路径）
5. 常见问题排查与优化建议
即使按照步骤操作，初学者仍可能遇到各种问题。以下是常见问题及解决方案：
5.1 编译错误排查
| 错误类型 | 可能原因 | 解决方案 |
|---|---|---|
| 找不到opencv2/opencv.hpp | 包含路径不正确 | 检查c_cpp_properties.json中的includePath |
| 未定义的引用 | 链接库缺失 | 确保tasks.json中链接了所有需要的库(-lopencv_*) |
| 版本不匹配 | 头文件和库版本不一致 | 统一使用相同版本的OpenCV |
5.2 运行时问题
-
图片无法加载：
- 检查图片路径是否正确（建议使用绝对路径）
- 确认图片格式受支持（JPEG、PNG等）
- 检查文件权限
-
窗口无法显示：
- 确保安装了GUI相关依赖（libgtk2.0-dev）
- 远程开发时可能需要配置X11转发
5.3 性能优化建议
-
编译优化：
- 在tasks.json中添加
-O3优化标志 - 使用
-march=native启用特定CPU优化
- 在tasks.json中添加
-
OpenCV特定优化：
- 启用TBB支持实现多线程
- 使用UMat代替Mat启用OpenCL加速
// 示例：使用UMat加速图像处理
cv::UMat image, grayImage;
cv::imread("image.jpg").copyTo(image);
cv::cvtColor(image, grayImage, cv::COLOR_BGR2GRAY);
- CMake集成： 对于大型项目，建议使用CMake管理构建过程。创建CMakeLists.txt：
cmake_minimum_required(VERSION 3.10)
project(OpenCV_Project)
find_package(OpenCV REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS})
add_executable(display_image src/display_image.cpp)
target_link_libraries(display_image ${OpenCV_LIBS})
6. 进阶学习路径与资源推荐
成功运行第一个OpenCV程序只是计算机视觉之旅的起点。为了帮助读者继续深入学习，以下是一些推荐的学习路径和资源：
-
OpenCV核心模块学习顺序：
- 图像基本操作（读取、显示、保存）
- 图像处理（滤波、形态学操作）
- 特征检测与描述
- 对象识别与跟踪
- 深度学习模块
-
推荐学习资源：
- 官方文档：OpenCV官方文档是最权威的参考资料
- 《Learning OpenCV 4》：适合系统学习OpenCV的书籍
- OpenCV GitHub仓库：查看最新特性和示例代码
-
项目实践建议：
- 从简单的图像处理工具开始（如滤镜应用）
- 尝试实现经典算法（如边缘检测、人脸检测）
- 参与开源项目或竞赛（如Kaggle计算机视觉比赛）
// 示例：简单的边缘检测程序
#include <opencv2/opencv.hpp>
using namespace cv;
int main() {
Mat image = imread("input.jpg", IMREAD_GRAYSCALE);
Mat edges;
Canny(image, edges, 50, 150);
imwrite("edges.jpg", edges);
return 0;
}
在实际开发中，我发现使用VSCode的CMake工具插件可以显著提高项目管理效率，特别是当项目规模扩大时。另外，定期备份.vscode配置文件可以节省在新环境中重新配置的时间。
Agent 垂直技术社区，欢迎活跃、内容共建。
更多推荐
2
0- 0
已为社区贡献5条内容
所有评论(0)