使用pip安装OpenCV-Python教程
使用 pip 安装 OpenCV-Python 教程
OpenCV（Open Source Computer Vision Library）是一个开源的计算机视觉和机器学习软件库。它包含了超过 2500 个优化的算法，可用于各种图像和视频分析任务，例如面部识别、对象检测、图像分割等。OpenCV 支持多种编程语言，其中 Python 是最受欢迎的语言之一。
本教程将详细指导您如何使用 pip 在不同的操作系统（Windows、macOS 和 Linux）上安装 OpenCV-Python。
一、准备工作
在开始安装之前，请确保您的系统满足以下要求：
- 已安装 Python：OpenCV-Python 需要 Python 环境。您可以从 Python 官方网站 (https://www.python.org/downloads/) 下载并安装最新版本的 Python。建议使用 Python 3.x 版本。
- 已安装 pip：pip 是 Python 的包管理工具，通常会随着 Python 一起安装。您可以在命令行中输入
pip --version或pip3 --version来检查是否已安装 pip 以及其版本。如果未安装，请参考 Python 官方文档进行安装。
二、安装步骤
在不同的操作系统上，安装步骤基本相同。以下将分别介绍在 Windows、macOS 和 Linux 上的安装过程。
1. Windows 系统
- 打开命令提示符 (CMD)： 可以通过在开始菜单中搜索 "cmd" 来打开命令提示符。
-
执行安装命令： 在命令提示符中输入以下命令并按下回车键：
bash
pip install opencv-python如果您希望安装包含额外模块 (contrib) 的 OpenCV，可以使用以下命令：
bash
pip install opencv-contrib-python这两个包的主要区别在于：
*opencv-python包含主要的 OpenCV 模块，适用于大多数的常见应用。
*opencv-contrib-python包含主要的 OpenCV 模块以及一些实验性的或者不常用的模块，这些模块可能不太稳定或者在将来的版本中发生变化。如果您需要使用一些特定算法例如 SIFT 或 SURF (这些算法已申请专利，在一些国家/地区可能不可免费使用)，则需要安装此包。注意：
opencv-python和opencv-contrib-python这两个包只能安装一个，不能同时安装。
* 等待安装完成： pip 将自动下载并安装 OpenCV-Python 及其依赖项。这可能需要一些时间，具体取决于您的网络速度。
* 验证安装： 安装完成后，您可以打开 Python 解释器（在命令提示符中输入python或python3）并尝试导入 OpenCV 模块来验证安装是否成功：python
import cv2
print(cv2.__version__)如果安装成功，将会打印出 OpenCV 的版本号，例如
4.8.0。
2. macOS 系统
- 打开终端 (Terminal)： 可以通过 Spotlight 搜索 "Terminal" 来打开终端。
-
执行安装命令： 在终端中输入以下命令并按下回车键：
bash
pip3 install opencv-python或安装包含额外模块的版本：
bash
pip3 install opencv-contrib-python
注意： macOS 系统可能自带了 Python 2.x 版本，所以建议使用pip3来为 Python 3.x 安装软件包。
* 等待安装完成： pip3 将自动下载并安装 OpenCV-Python 及其依赖项。
* 验证安装： 安装完成后，您可以打开 Python 3 解释器（在终端中输入python3）并尝试导入 OpenCV 模块来验证安装是否成功：python
import cv2
print(cv2.__version__)如果安装成功，将会打印出 OpenCV 的版本号。
3. Linux 系统
- 打开终端 (Terminal)： 您可以通过快捷键
Ctrl + Alt + T或在应用程序菜单中找到终端。 -
执行安装命令： 在终端中输入以下命令并按下回车键：
bash
pip3 install opencv-python或安装包含额外模块的版本：
bash
pip3 install opencv-contrib-python
注意： 多数 Linux 发行版自带了 Python 2.x 版本，所以建议使用pip3来为 Python 3.x 安装软件包。某些 Linux 发行版可能需要您使用sudo命令获取管理员权限来安装软件包。
* 等待安装完成： pip3 将自动下载并安装 OpenCV-Python 及其依赖项。
* 验证安装： 安装完成后，您可以打开 Python 3 解释器（在终端中输入python3）并尝试导入 OpenCV 模块来验证安装是否成功：python
import cv2
print(cv2.__version__)如果安装成功，将会打印出 OpenCV 的版本号。
三、常见问题及解决方法
-
安装速度慢： 可以尝试更换 pip 的软件源为国内镜像源，例如清华大学的镜像源：
bash
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple opencv-python -
ImportError: libGL.so.1: cannot open shared object file: No such file or directory： 在某些 Linux 系统上，特别是服务器版本或者没有图形界面的系统，可能会遇到这个错误。这通常是因为缺少 OpenGL 库。您可以尝试安装以下软件包：
bash
sudo apt-get update
sudo apt-get install libgl1-mesa-glx如果您使用的是其他的 Linux 发行版，请使用相应的包管理器安装
libgl1相关的包。 -
其他错误： 如果您遇到其他错误，建议您仔细阅读错误信息，并尝试在网上搜索解决方案。您还可以参考 OpenCV 的官方文档或者在相关的论坛上寻求帮助。
四、总结
使用 pip 安装 OpenCV-Python 是一个相对简单的过程。本教程详细介绍了在 Windows、macOS 和 Linux 系统上的安装步骤，并提供了一些常见问题的解决方法。希望本教程能够帮助您成功安装 OpenCV-Python，并开始您的计算机视觉之旅！如果您有任何问题，欢迎随时提问。