ubuntu20.04下使用vscode配置OpenCV(C++/python)环境

作者声明：我是一名初学者，查询了一些帖子跟着配置环境，本贴对配置过程进行了一些整合。刚开始配置好环境发现是在 C++ 中使用的，我一开始学习的是在 python 中使用，因此又在原有基础上配置环境，但根据我查到的情况来看，如果只是配置 python 中的环境，应该可以直接从第四步开始，应该！我没试过！

一、安装 vscode

1. 在vscode官网下载deb包

vscode官网

2. 打开终端

<filename.deb> 替换为你自己的文件名

sudo dpkg -i <filename.deb>

3. 打开vscode

终端中输入 code 即可打开。

二、配置 opencv 环境

1. 下载 opencv

https://opencv.org/releases/

我下载的是4.12.0版本，点击sources即可下载

2. 安装 opencv

2.1 解压

自行选择位置解压

unzip opencv-4.12.0.zip

2.2 安装编译所需要的库

sudo apt update sudo apt upgrade sudo apt install g++ sudo apt install cmake sudo apt install make

2.3  安装 opencv 依赖项

在Ubuntu系统上安装OpenCV的依赖库时，可以根据你的需求选择安装基础依赖或扩展依赖。以下是一些推荐的依赖库及其安装命令，这些依赖库能够满足大多数OpenCV的使用场景。

sudo apt update sudo apt install -y build-essential cmake git pkg-config \ libjpeg-dev libpng-dev libtiff-dev libjasper-dev \ libavcodec-dev libavformat-dev libswscale-dev \ libgtk-3-dev libdc1394-22-dev python3-dev python3-numpy

2.4 进入解压过后的 opencv 文件夹

cd opencv-4.12.0

创建一个build文件夹并进入

mkdir build cd build

2.5 下载编译

cmake -D CMAKE_BUILD_TYPE=Release \ -D OPENCV_GENERATE_PKGCONFIG=YES \ -D CMAKE_PREFIX_PATH=/usr/lib/x86_64-linux-gnu \ -D CMAKE_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu \ ..

2.6 编译

make -j$(nproc) # Linux系统自动获取逻辑核心数

2.7 安装

sudo make install

其中，opencv4的安装路径为：/usr/local/include/opencv4

库文件的路径为：/usr/local/lib

3. 配置 opencv 编译环境

3.1 将 opencv 的库添加到路径

sudo gedit /etc/ld.so.conf.d/opencv4.conf

打开后是一个空白文件，在文末添加

/usr/local/lib

3.2 使路径生效

sudo ldconfig

3.3 配置bash

sudo gedit /etc/bash.bashrc

在文末添加

PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig export PKG_CONFIG_PATH

使配置生效

source /etc/bash.bashrc

3.4 检验是否安装成功

pkg-config --modversion opencv4

安装成功

三、在 vscode 中配置 opencv（C++） 环境

1. 新建 vscode 工程

2. 安装插件

重启 vscode

3. 配置 vscode

新建文件：c_cpp_properties.json，launch.json，tasks.json

1. 配置 c_cpp_properties.json

{ "configurations": [ { "name": "Linux", "includePath": [ "${workspaceFolder}/**", "/usr/local/include/opencv4", "/usr/include/" ], "defines": [], "compilerPath": "/usr/bin/gcc", "cStandard": "c17", "cppStandard": "gnu++14", "intelliSenseMode": "linux-gcc-x64" } ], "version": 4 }

往里面添加 opencv4 路径：

"/usr/local/include/opencv4"

按下“ctrl+shift+p”，搜索打开如下图所示配置：

2. 配置 task.json 文件

{ "version": "2.0.0", "tasks": [ { "type": "cppbuild", "label": "C/C++: g++ build active file", "command": "/usr/bin/g++", "args": [ "-std=c++11", "-g", "${fileDirname}/*.cpp", "-o", "${fileDirname}/${fileBasenameNoExtension}", "-I", "${workspaceFolder}/", "-I","/usr/local/include/", "-I","/usr/local/include/opencv4/", "-I","/usr/local/include/opencv4/opencv2", "-L","/usr/local/lib", "/usr/local/lib/libopencv_*" ], "options": { "cwd": "${fileDirname}" }, "problemMatcher": [ "$gcc" ], "group": { "kind": "build", "isDefault": true }, "detail": "Task generated by Debugger." } ] }

3. 配置 launch.json 文件

{ "version": "0.2.0", "configurations": [ { "name": "g++ - Build and debug active file", "type": "cppdbg", "request": "launch", "program": "${fileDirname}/${fileBasenameNoExtension}", "args": [], "stopAtEntry": false, "cwd": "${fileDirname}", "environment": [], "externalConsole": true, "MIMode": "gdb", "setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ], "preLaunchTask": "C/C++: g++ build active file", "miDebuggerPath": "/usr/bin/gdb" } ] }

4. 测试

新建 test.cpp 文件，记得替换自己的图片路径

#include <opencv2/opencv.hpp> #include <iostream> using namespace std; using namespace cv; int main() { Mat img = imread("/home/wxl/wxl_study_file/OpenCV_practice/test_picture.png", 1); namedWindow("img", WINDOW_FREERATIO); imshow("img", img); waitKey(0); destroyAllWindows(); return 0; }

点击右上角运行程序，自动生成对应的二进制文件

四、在 vscode 中配置 opencv（python） 环境

1. 前面的操作中已经安装了 python3，检查：

python3 --version

没有的话自己在安装 python

2. 检查有无 pip3 ，若无则安装：

sudo apt install python3-pip

3. 安装依赖项，安装 libopencv-dev 依赖包：

sudo apt install libopencv-dev

4. 安装 opencv-python 库

因为系统中已经安装了python3和pip3，所以直接运行。

sudo pip3 install opencv-python

成功之后运行 python3，依次输入：

import cv2 print(cv2.__version__) # 前后各两个下划线

环境配置成功

5. vscode 中安装插件

6. 编写测试文件

import cv2 # 读取图片 image = cv2.imread('test_picture.png') cv2.imshow('Image', image) cv2.waitKey(0) cv2.destroyAllWindows()

运行：

参考文章：

ubuntu安装VSCode并配置opencv_ubuntu vscode配置opencv-ZEEKLOG博客

Unbuntu系统下VScode中配置opencv（c++）环境_ubuntu c++ opencv-ZEEKLOG博客

ubuntu 配置 opencv python安装路径 export ubuntu安装opencv库_mob64ca1418736f的技术博客_51CTO博客