第三节：OpenCV 基础入门-安装与配置 OpenCV (Python/C++ 环境)

摸鱼许可证

于 2025-05-04 12:55:41 发布

阅读量206

点赞数 7

分类专栏：从零开始学习OpenCV 文章标签： opencv python c++

本文链接：https://blog.csdn.net/2501_91516851/article/details/147693705

版权

从零开始学习OpenCV 专栏收录该内容

5 篇文章

订阅专栏

一、环境准备

1.1 系统要求

Windows 10/11 64位
Ubuntu 20.04 LTS或更新版本
macOS Monterey及以上
Python 3.6+ 或 C++17编译器

1.2 必备工具

# 通用依赖项
- CMake 3.12+
- Git版本控制工具
- 开发工具链（gcc/clang/MSVC）

二、Python环境安装

2.1 Windows环境

# 使用pip快速安装
pip install opencv-python

# 包含contrib模块
pip install opencv-contrib-python

2.2 Ubuntu环境

# 安装系统依赖
sudo apt-get install -y \
    libopencv-dev \
    python3-opencv \
    libgtk2.0-dev

2.3 macOS环境

# 使用Homebrew安装
brew install opencv@4
echo 'export PATH="/opt/homebrew/opt/opencv@4/bin:$PATH"' >> ~/.zshrc

三、C++环境编译指南

3.1 源码编译通用步骤

git clone https://github.com/opencv/opencv.git
mkdir build && cd build
cmake -D CMAKE_BUILD_TYPE=RELEASE \
      -D CMAKE_INSTALL_PREFIX=/usr/local \
      -D WITH_CUDA=ON \
      ..
make -j$(nproc)
sudo make install

3.2 Windows特殊配置

# CMake配置需指定生成器
cmake -G "Visual Studio 16 2019" -A x64 ..

四、环境验证

4.1 Python验证脚本

import cv2
print(f"OpenCV版本：{cv2.__version__}")
print(f"编译信息：{cv2.getBuildInformation()}")

4.2 C++验证程序

#include <opencv2/core.hpp>
#include <iostream>

int main() {
    std::cout << "OpenCV版本：" << CV_VERSION << std::endl;
    return 0;
}

五、常见问题解决

Q1: 导入cv2时提示DLL加载失败
解决方案：安装VC Redistributable包，或通过conda安装：
conda install -c conda-forge opencv

Q2: 视频编解码支持问题
编译时添加FFmpeg支持：
-D WITH_FFMPEG=ON

六、进阶配置

6.1 Python虚拟环境集成

# 创建虚拟环境
python -m venv opencv_env
source opencv_env/bin/activate

# 安装定制化版本
pip install opencv-python==4.5.5.64

6.2 多版本共存管理

# 使用符号链接管理版本
sudo ln -sf /usr/local/opencv-4.5.5 /usr/local/opencv