OpenCV安装指南：从预编译版本到源码编译全解析

卫伊祺Ralph

于 2025-05-30 09:02:19 发布

阅读量272

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00486/article/details/148323324

OpenCV安装指南：从预编译版本到源码编译全解析

opencv 项目地址: https://gitcode.com/gh_mirrors/op/opencv

前言

OpenCV作为计算机视觉领域最受欢迎的开源库之一，其安装方式多样且灵活。本文将全面介绍OpenCV的安装方法，帮助开发者根据自身需求选择最适合的安装方案。

一、预编译版本安装

对于大多数开发者而言，使用预编译版本是最快捷的安装方式。

1.1 官方预编译版本

OpenCV核心团队为以下平台提供官方预编译版本：

Android平台
iOS平台
Windows平台

这些版本使用最新编译器构建，但不包含opencv_contrib模块中的额外功能。

1.2 第三方预编译版本

除官方版本外，还有许多第三方维护的预编译版本：

Linux发行版的系统软件包
Python的PyPI包
Conda环境下的OpenCV包
Windows平台的NuGet包
macOS的Homebrew包
Java的Maven仓库

这些第三方版本通常会针对特定环境进行优化，建议根据开发环境选择合适的版本。

二、源码编译安装

当预编译版本无法满足需求时，源码编译是最灵活的解决方案。

2.1 准备工作

在开始编译前，需要确保系统具备以下工具：

C++编译器（GCC/Clang/MSVC等）
构建工具（Make/Ninja等）
CMake（3.5.2或更高版本）
相关依赖库（视功能需求而定）

2.2 获取源代码

OpenCV的源代码主要分布在三个仓库中：

opencv：核心模块，包含稳定算法
opencv_contrib：额外模块，包含实验性算法
opencv_extra：测试数据

获取方式有两种：

下载特定版本的源码压缩包
使用Git克隆仓库（推荐）

git clone https://github.com/opencv/opencv
git clone https://github.com/opencv/opencv_contrib

注意：opencv和opencv_contrib的版本必须匹配。

2.3 配置构建选项

使用CMake进行配置是编译过程的关键步骤：

mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release \
      -DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules \
      ../opencv

常用配置选项：

BUILD_EXAMPLES：是否构建示例程序
WITH_CUDA：启用CUDA加速
OPENCV_ENABLE_NONFREE：启用专利算法

2.4 编译与安装

配置完成后即可开始编译：

cmake --build . --config Release --parallel 8
sudo cmake --install .

编译时间取决于硬件配置，建议使用多核并行编译以加快速度。

2.5 可选插件构建

OpenCV支持将部分功能模块化为插件：

| 模块 | 支持的插件 | 位置 | |----------|--------------------------|-------------------------------| | core | TBB/OpenMP并行后端 | modules/core/misc/plugins | | highgui | GTK相关GUI后端 | modules/highgui/misc/plugins | | videoio | 视频编解码后端 | modules/videoio/misc |

插件构建示例：

cmake -DOPENCV_PLUGIN_NAME=opencv_core_tbb \
      -DOPENCV_PLUGIN_DESTINATION=/usr/local/lib/opencv4/plugins \
      ../opencv/modules/core/misc/plugins/parallel_tbb