OpenCV在Windows系统下的安装与编译指南

羿丹花Zea

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

阅读量407

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00915/article/details/148323372

OpenCV在Windows系统下的安装与编译指南

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

前言

OpenCV作为计算机视觉领域最流行的开源库之一，在Windows平台上的安装方式主要有两种：使用预编译库和从源码编译。本文将详细介绍这两种方法，并针对不同用户需求提供专业建议。

预编译库安装方法

适用场景

快速开始OpenCV开发
使用最新版Visual Studio IDE
不需要自定义功能模块

安装步骤

获取预编译包：
- 访问官方提供的预编译库资源
- 选择与您系统架构匹配的版本（32位或64位）
解压安装：
- 需要管理员权限
- 建议解压到不含中文和空格的路径，如C:\OpenCV
环境配置：
- 将OpenCV的bin目录（如C:\OpenCV\build\x64\vc15\bin）添加到系统PATH环境变量
- 在Visual Studio项目中配置包含目录和库目录

优缺点分析

优点：安装简单快捷，适合初学者
缺点：功能固定，无法自定义模块

使用Git-bash和CMake编译

环境准备

Git-bash 2.14.1或更高版本
CMake 3.9.1或更高版本
Visual Studio 2015/2017/2019

自动化编译脚本

#!/bin/bash -e
myRepo=$(pwd)
CMAKE_GENERATOR_OPTIONS=-G"Visual Studio 16 2019"
CMAKE_OPTIONS=(-DBUILD_PERF_TESTS:BOOL=OFF -DBUILD_TESTS:BOOL=OFF -DBUILD_DOCS:BOOL=OFF -DWITH_CUDA:BOOL=OFF)

关键参数说明

-G：指定生成器，对应不同VS版本
-DOPENCV_EXTRA_MODULES_PATH：指定contrib模块路径
-DCMAKE_INSTALL_PREFIX：设置安装目录

编译过程

克隆opencv和opencv_contrib仓库
创建build目录
执行CMake配置
分别编译Debug和Release版本

从源码编译完整OpenCV

开发环境要求

Visual Studio 2015/2017/2019（推荐使用最新版）
CMake 3.5+
Git客户端

第三方依赖项

Python支持：
- Python 2.7.x或3.x
- NumPy科学计算包
性能优化库：
- Intel TBB（多线程支持）
- Intel IPP（性能优化）
- CUDA Toolkit（GPU加速）
扩展功能：
- Qt框架（增强GUI功能）
- OpenNI（深度摄像头支持）
- Eigen（线性代数运算）

详细编译步骤

获取源码：
- 使用Git克隆官方仓库
- 建议同时获取opencv_contrib模块

CMake配置：

cmake -G "Visual Studio 16 2019" -DCMAKE_BUILD_TYPE=Release \
-DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules \
-DBUILD_EXAMPLES=ON ..

常见配置选项：
- WITH_CUDA：启用CUDA支持
- WITH_QT：启用Qt界面支持
- BUILD_EXAMPLES：编译示例程序
- ENABLE_SOLUTION_FOLDERS：组织解决方案目录
编译安装：
- 在Visual Studio中打开生成的解决方案
- 选择INSTALL项目进行生成
- 或使用命令行：
```
cmake --build . --config Release --target INSTALL
```