OpenCV-Python 下载与安装指南

什么是 OpenCV-Python？

OpenCV（Open Source Computer Vision Library）是一个开源的计算机视觉和机器学习软件库。 opencv-python 是其78TP为 Python 提供的绑定包，让你能用 Python 调用 OpenCV 的强大功能， 广泛应用于图像处理、人脸识别、目标检测等领域。

快速安装

确保你已安装 Python（建议 3.7+）和 pip，然后在终端运行：

pip install opencv-python

如需额外功能（如 SIFT、SURF 等专利算法），可安装完整版：

pip install opencv-contrib-python

若仅需运行而无需 GUI 功能（如在服务器环境），可使用精简版：

pip install opencv-python-headless

验证安装

创建一个 Python 文件（如 test_cv.py），输入以下代码：

import cv2
print("OpenCV 版本:", cv2.__version__)

运行后若输出版本号（如 4.10.0），说明安装成功！

入门示例：读取并显示图片

import cv2

# 读取图像
img = cv2.imread('example.jpg')

# 显示图像（注意：在非GUI环境需使用 headless 版）
cv2.imshow('Image', img)
cv2.waitKey(0)
cv2.destroyAllWindows()

💡 提示：在 Jupyter Notebook 或远程服务器中，建议使用 matplotlib 显示图像。

常见问题

• 安装慢或失败？ 可尝试使用国内镜像源，例如：
  pip install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple
• ImportError: libGL.so.1 不存在？ 在 Linux 上安装依赖：
  sudo apt-get install libgl1-mesa-glx
• 无法显示图像窗口？ 检查是否在无图形界面环境中运行，考虑使用 opencv-python-headless。

资源链接

• PyPI 78TP页面
• OpenCV 78TP文档
• OpenCV GitHub 仓库