📚 课程目录第3章 OpenCV环境搭建

3、OpenCV环境搭建：Windows/Linux下配置OpenCV-Python

说实话，很多同学学计算机视觉，第一关就卡在环境搭建上。我记得有个学生，花了两天装OpenCV，最后发现是Python版本和pip源的问题。嗯，这节课我们就把这个坑填平。

OpenCV-Python，说白了就是OpenCV的Python接口。你不需要写C++，直接用Python就能调用底层优化的图像处理函数。我个人习惯用pip安装，简单省事。但不同系统确实有些小差异，我们一个一个说。

3.1 环境准备：Python与pip

在装OpenCV之前，你得先确认Python环境是好的。我建议用Python 3.7以上版本，太老的版本有些新功能不支持。

最低要求：

Python ≥ 3.7
pip ≥ 19.0（最好升级到最新）
操作系统：Windows 10/11 或 Ubuntu 18.04+ / CentOS 7+

检查Python版本，打开终端（Windows用cmd或PowerShell，Linux用bash），输入：

python --version
pip --version

如果pip版本太旧，先升级一下：

python -m pip install --upgrade pip

为什么要升级pip？我曾经遇到过因为pip版本太低，装OpenCV时死活找不到匹配的wheel包。升级后一次搞定。

3.2 Windows下安装OpenCV-Python

Windows下安装其实是最简单的。直接一条命令：

pip install opencv-python

这会安装OpenCV的核心模块，包括图像读写、处理、特征提取等。如果你还需要用到SIFT、SURF等专利算法（虽然现在专利过期了），可以装扩展包：

pip install opencv-contrib-python

小提示： 如果你只是做棋盘格角点提取和相机标定，装 opencv-python 就够了。contrib包更大，有些模块你可能用不上。

安装完成后，验证一下：

python -c "import cv2; print(cv2.__version__)"

如果输出版本号，比如 4.8.1，说明安装成功。

注意： 有些Windows用户会遇到 DLL load failed 错误。这通常是因为系统缺少Visual C++运行库。去微软官网下载安装 Visual C++ Redistributable for Visual Studio 2015-2022 就能解决。我踩过这个坑，折腾了半小时才发现是运行库的问题。

3.3 Linux下安装OpenCV-Python

Linux下安装，我个人更推荐用系统包管理器，而不是直接pip。为什么？因为系统包管理器会自动处理依赖，比如GTK、FFmpeg这些底层库。

Ubuntu/Debian系：

sudo apt update
sudo apt install python3-opencv

如果你想用pip装最新版，也可以：

pip install opencv-python

但要注意，pip装的可能缺少一些GUI功能（比如 cv2.imshow() 用不了）。你想想看，如果标定的时候连图像都显示不了，多难受。

CentOS/RHEL/Fedora系：

sudo yum install opencv-python   # CentOS 7
sudo dnf install opencv-python   # Fedora

验证方式一样：

python3 -c "import cv2; print(cv2.__version__)"

经验之谈： 我在Ubuntu 20.04上遇到过一个问题——pip安装的OpenCV无法读取视频文件。后来发现是缺少FFmpeg解码库。解决方案是用apt先装 ffmpeg 和 libavcodec-extra，再装opencv。顺序很重要。

3.4 安装验证与常见问题

装完之后，我建议你跑一个完整的验证脚本，确保所有功能正常：

import cv2
import numpy as np

# 检查版本
print("OpenCV版本:", cv2.__version__)

# 检查是否支持GUI
try:
    img = np.zeros((100, 100, 3), dtype=np.uint8)
    cv2.imshow("test", img)
    cv2.waitKey(1)
    cv2.destroyAllWindows()
    print("GUI支持: 正常")
except:
    print("GUI支持: 异常（不影响标定，但无法显示图像）")

# 检查是否支持视频读取
cap = cv2.VideoCapture(0)
if cap.isOpened():
    print("摄像头读取: 正常")
    cap.release()
else:
    print("摄像头读取: 未检测到（不影响标定）")

这个脚本会告诉你三个关键信息：版本、GUI、摄像头。对于棋盘格标定来说，GUI不是必须的，但有的话调试起来方便很多。

3.5 知识体系总览

下面这张图帮你理清OpenCV环境搭建的整体脉络：

3.6 环境对比速查表

项目	Windows	Linux (Ubuntu)	Linux (CentOS)
推荐安装方式	pip	apt + pip	yum/dnf + pip
核心命令	`pip install opencv-python`	`sudo apt install python3-opencv`	`sudo yum install opencv-python`
GUI支持	默认支持	需安装GTK依赖	需安装GTK依赖
视频支持	默认支持	需安装FFmpeg	需安装FFmpeg
常见问题	DLL加载失败	缺少系统库	Python版本冲突

我的建议： 如果你是初学者，用Windows + pip安装最省心。如果你做项目部署，Linux + apt安装更稳定。我自己平时开发用Windows，部署到服务器用Ubuntu。

3.7 避坑指南

最后，总结几个我踩过的坑，你遇到了直接照方抓药：

pip安装慢？ 换国内镜像源：pip install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple
import cv2报错？ 检查Python位数（32位/64位）是否和OpenCV包匹配。我曾经在32位Python上装了64位的包，折腾半天才发现。
cv2.imshow()闪退？ 加上 cv2.waitKey(0) 再 cv2.destroyAllWindows()，这是OpenCV的GUI事件循环机制。
Linux下摄像头打不开？ 检查用户权限，把用户加到 video 组：sudo usermod -aG video $USER，然后注销重登。