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

拾忆-eleven2025-05-06 15:48

一、环境准备

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