ubuntu20.04安装opencv3.4.5
时间: 2025-06-13 10:43:16 浏览: 16
### 安装 OpenCV 3.4.5 的详细指南
在 Ubuntu 20.04 上安装 OpenCV 3.4.5 可以通过以下方法完成。以下是完整的流程:
#### 准备工作
确保系统已更新至最新状态:
```bash
sudo apt update && sudo apt upgrade -y
```
安装必要的依赖项,这些工具和库用于编译和构建 OpenCV:
```bash
sudo apt install build-essential cmake git pkg-config libgtk-3-dev \
libavcodec-dev libavformat-dev libswscale-dev libv4l-dev \
libxvidcore-dev libx264-dev libjpeg-dev libpng-dev libtiff-dev \
gfortran openexr libatlas-base-dev python3-dev python3-numpy \
libtbb2 libtbb-dev libdc1394-22-dev -y
```
此命令涵盖了大多数常见的依赖项[^3]。
#### 下载 OpenCV 和 OpenCV_contrib 源码
从 GitHub 获取 OpenCV 和 OpenCV_contrib 的源码包:
```bash
cd ~
git clone https://github.com/opencv/opencv.git
git clone https://github.com/opencv/opencv_contrib.git
```
切换到指定版本(3.4.5):
```bash
cd ~/opencv
git checkout 3.4.5
cd ~/opencv_contrib
git checkout 3.4.5
```
#### 配置 CMake
进入 `opencv` 文件夹并创建一个名为 `build` 的子文件夹来存储编译结果:
```bash
cd ~/opencv
mkdir build
cd build
```
运行 CMake 命令配置项目环境,并指向 `opencv_contrib` 中的额外模块路径:
```bash
cmake -D CMAKE_BUILD_TYPE=RELEASE \
-D CMAKE_INSTALL_PREFIX=/usr/local \
-D INSTALL_C_EXAMPLES=ON \
-D INSTALL_PYTHON_EXAMPLES=ON \
-D WITH_TBB=ON \
-D WITH_V4L=ON \
-D WITH_QT=OFF \
-D WITH_OPENGL=ON \
-D OPENCV_EXTRA_MODULES_PATH=~/opencv_contrib/modules ..
```
上述命令中的 `-D OPENCV_EXTRA_MODULES_PATH` 参数指定了 contrib 模块的位置[^4]。
#### 编译与安装
执行 `make` 进行编译操作。建议使用多线程加速编译过程:
```bash
make -j$(nproc)
```
完成后,将生成的二进制文件安装到 `/usr/local/lib/python3.x/dist-packages/cv2.cpython*.so` 路径下:
```bash
sudo make install
sudo ldconfig
```
验证安装是否成功:
```python
import cv2
print(cv2.__version__)
```
如果输出为 `3.4.5` 或其他对应版本号,则说明安装成功。
---
### 解决常见问题
如果遇到类似 `fatal error: opencv2/xfeatures2d/cuda.hpp: No such file or directory` 的错误,可能是由于未正确设置 CUDA 支持或者缺少某些头文件引起的。可以通过重新调整 CMake 配置参数解决该问题[^1]。
---
### 总结
以上步骤提供了详细的指导,帮助用户顺利完成 OpenCV 3.4.5 在 Ubuntu 20.04 系统上的安装。遵循每一步骤可以有效减少潜在错误的发生概率。
阅读全文
相关推荐









