CV

基于 OpenCV 5.0 官方文档 · 中文整理

开源计算机视觉库的中文指南

从像素类型到深度学习推理，系统整理 OpenCV 5.0 的模块、API 与实践。

开始阅读安装指南
quickstart.pyPython
import cv2

img = cv2.imread("cat.jpg")        # 读取图像（BGR 顺序）
gray = cv2.cvtColor(img, cv2.COLOR_BGR2GRAY)
edges = cv2.Canny(gray, 50, 150)   # Canny 边缘检测

cv2.imshow("edges", edges)
cv2.waitKey(0)

更多语言入口见示例代码

2,500+
优化算法
4
语言接口
17
主模块
80%+
ONNX 覆盖率

OpenCV 5.0 亮点

在 4.x 基础上构建的重大版本。

2500+ 优化算法

经典与前沿的计算机视觉、机器学习方法的完整组合，覆盖人脸检测、目标识别、动作分类、运动跟踪、3D 重建与全景拼接。

多语言接口

提供 C++、Python、Java、JavaScript（OpenCV.js）接口，可运行于 Windows、Linux、macOS、Android 与 iOS。

异构加速

通过 SIMD（Universal Intrinsics 2.0：SSE/AVX/NEON/SVE/RISC-V）、CUDA、OpenCL 与 Vulkan 加速计算。

OpenCV 5.0 重大版本

最低要求 C++17，移除 Python 2 与遗留 C API；新增 CV_16BF 等数据类型；calib3d 拆分为 geometry、calib、stereo、ptcloud。

新一代 DNN 引擎

ONNX 规范覆盖率从不足 23% 提升至 80% 以上，集成 ONNX Runtime，模型托管于 Hugging Face。

性能大幅提升

图像 warp 加速 10% 至 300%+；USAC 成为鲁棒估计默认框架；Vulkan 计算支持。

能做什么

典型应用领域一览。

  • 人脸检测与识别

    objdetect 中的 Haar/DNN 人脸、眼睛、微笑检测，以及人脸识别流水线。

  • 图像处理

    滤波、边缘检测、形态学、几何变换、直方图均衡、色彩空间转换。

  • 视频分析

    背景减除、光流、Meanshift/Camshift、KCF/CSRT 目标跟踪。

  • 目标检测

    通过 dnn 模块运行 YOLO、SSD、EfficientDet 等检测模型。

  • 相机标定与 3D

    棋盘格标定、立体校正、视差计算、PnP 位姿估计、点云处理。

  • 全景拼接

    stitching 模块：特征匹配、柱面/球面投影、多带融合生成全景图。

  • 特征匹配

    SIFT、ORB、AKAZE 等检测描述子与 FLANN 匹配，用于图像检索与拼接。

  • 计算摄影

    photo 模块：去噪、HDR、卡通化、图像修复（inpainting）。

  • 浏览器端视觉

    OpenCV.js 将核心算法编译为 WebAssembly，在浏览器中实时处理。

语言接口

同一套算法，四种语言入口。

C++

原生 API，性能最佳；5.0 要求 C++17
#include <opencv2/imgcodecs.hpp>
auto img = cv::imread("cat.jpg");

Python

pip 安装，原型开发首选；需 Python 3.6+
import cv2
img = cv2.imread("cat.jpg")

Java

Android 开发常用绑定
Mat img = Imgcodecs.imread("cat.jpg");

JavaScript

OpenCV.js，WebAssembly 运行
let img = cv.imread("canvas");

快速导航

入门简介

模块结构与 8 大核心 API 概念

安装配置

CMake / g++ / Python 环境搭建

核心模块

17 个主模块功能详解

像素数据类型

CV_8U 到 CV_Bool 完整参考

教程指南

C++ / Python / JS 教程体系

深度学习

DNN 引擎、后端与模型加载

示例代码

开箱即用的多语言示例

社区资源

论坛、课程、频道与参与方式

从 4.x 到 5.0

方面OpenCV 4.xOpenCV 5.0
C++ 标准C++11 起步最低 C++17
Python2/3（部分版本）仅 Python 3.6+
C API已弃用完全移除
数据类型CV_8U ~ CV_64F、CV_16F新增 CV_16BF、CV_32U、CV_64U、CV_64S、CV_Bool；支持 0D/1D 数组
模块划分calib3d 单一模块拆分为 geometry / calib / stereo / ptcloud
DNNONNX 覆盖 < 23%ONNX 覆盖 > 80%；ONNX Runtime 集成；Hugging Face 模型
性能Universal Intrinsics 1.x2.0（含 SVE/RISC-V）；warp 加速 10%~300%+；Vulkan 计算；USAC 默认