OpenCV Python 环境配置与安装指南 – wiki词典

OpenCV Python 环境配置与安装指南

OpenCV (Open Source Computer Vision Library) 是一个功能强大的计算机视觉和机器学习库。本文将详细指导您如何在 Python 环境中配置和安装 OpenCV。

1. 前提条件

在安装 OpenCV 之前，请确保您的系统满足以下条件：

• Python: 推荐使用 Python 3.x 版本。您可以从 Python 官方网站 下载并安装。

• pip: Python 的包管理器，通常随 Python 安装包一同提供。请确保您的 pip 版本是最新的，以避免兼容性问题。可以通过以下命令升级 pip：

  bash
python -m pip install --upgrade pip

2. 使用虚拟环境 (强烈推荐)

为了避免项目依赖冲突，并保持系统 Python 环境的整洁，强烈建议为每个项目使用独立的 Python 虚拟环境。

创建虚拟环境:
在您的项目目录下，运行以下命令创建一个虚拟环境 (例如，命名为 my_opencv_env):

bash
python -m venv my_opencv_env

激活虚拟环境:
* Windows 系统:
bash
.\my_opencv_env\Scripts\activate
* macOS/Linux 系统:
bash
source my_opencv_env/bin/activate
成功激活后，您的终端提示符前会显示虚拟环境的名称。

3. 安装 OpenCV

您可以使用 pip 来安装 OpenCV。请注意，有几个不同的软件包可供选择，但只能安装其中一个，以避免潜在的冲突。

• 主模块包 (opencv-python): 这是最常见的选择，包含了 OpenCV 的核心功能。
  bash
pip install opencv-python
• 完整包 (包含 contrib/extra 模块 opencv-contrib-python): 除了主模块外，还包括了额外的 “contrib” 模块，这些模块可能包含实验性或不常用的功能。
  bash
pip install opencv-contrib-python
• 无头版本 (headless): 如果您在没有图形界面的服务器或系统上工作，可以考虑安装无头版本，这些版本不包含 GUI 相关功能。
  • 主模块 (无头): pip install opencv-python-headless
  • 完整包 (无头): pip install opencv-contrib-python-headless

重要提示: 请勿在同一环境中安装多个不同的 opencv-python 软件包。如果意外安装了多个，请先全部卸载 (pip uninstall opencv-python opencv-contrib-python)，然后再安装您所需的单个软件包。

4. 验证安装

安装完成后，您可以通过以下步骤验证 OpenCV 是否已正确安装并可在 Python 环境中使用：

1. 激活您的虚拟环境 (如果之前创建了)。
2. 在终端中输入 python，进入 Python 解释器。

3. 导入 OpenCV 并检查其版本:

   python
import cv2
print(cv2.__version__)
   如果安装成功，此命令将打印已安装的 OpenCV 版本号 (例如: ‘4.5.1’)。

5. 故障排除

• ModuleNotFoundError: No module named 'cv2': 这通常意味着 OpenCV 未在当前 Python 环境中安装，或者您的虚拟环境未激活。
• pip 版本过旧: 确保您的 pip 已按照前提条件中的说明进行更新。
• 与手动安装冲突: 如果您之前手动安装过 OpenCV，可能会与 pip 安装发生冲突。在使用 pip 安装之前，请移除所有手动安装的版本。