在 CentOS 上安装 OpenCV 是一个多步骤的过程,涉及安装依赖项、下载和配置 OpenCV 源代码,以及编译和安装,下面是一个详细的指南,包括每一步的说明和示例代码。
安装依赖项
在安装 OpenCV 之前,需要先安装一些必要的依赖项,这些依赖项包括编译器、构建工具和其他库。

1、更新系统包管理器和安装基本开发工具:
- sudo yum update y
- sudo yum groupinstall "Development Tools"
2、安装额外的依赖项:
- sudo yum install epelrelease y
- sudo yum install cmake3 qt5qtbasedevel libv4ldevel gstreamerpluginsbase1devel python3devel numpy y
3、安装其他可能需要的库(根据具体需求):
- sudo yum install libpngdevel jasperdevel openexrdevel libwebpdevel libjpegturbodevel libtiffdevel tbbdevel eigen3devel freeglutdevel mesalibGL mesalibGLdevel boost boostthread boostdevel gstreamer1pluginsbase y
4、安装 Python pip(如果尚未安装):
- sudo yum install python3 y
- sudo yum install python3pip y
下载和配置 OpenCV 源代码
1、创建目录并克隆 OpenCV 和 OpenCV contrib 仓库:
- mkdir ~/opencv_build && cd ~/opencv_build
- git clone https://github.com/opencv/opencv.git
- git clone https://github.com/opencv/opencv_contrib.git
2、创建一个临时构建目录并切换到该目录:

- cd ~/opencv_build/opencv && mkdir build && cd build
3、使用 CMake 配置 OpenCV 构建:
- cmake3 D CMAKE_BUILD_TYPE=RELEASE \
- D CMAKE_INSTALL_PREFIX=/usr/local \
- D INSTALL_C_EXAMPLES=ON \
- D INSTALL_PYTHON_EXAMPLES=ON \
- D OPENCV_GENERATE_PKGCONFIG=ON \
- D BUILD_EXAMPLES=ON ..
编译和安装 OpenCV
1、编译 OpenCV:
- make j$(nproc)
2、安装 OpenCV:
- sudo make install
配置环境变量和库路径
1、添加库路径:
- sudo ln s /usr/local/lib64/pkgconfig/opencv4.pc /usr/share/pkgconfig/
- sudo ldconfig
2、添加环境变量:
编辑/etc/profile
文件,在文件末尾另起行加入以下内容:

- export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib64/pkgconfig
- export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib64
保存并退出,然后使配置生效:
- source /etc/profile
3、复制opencv.pc
文件到默认路径:
- cp /usr/local/lib64/pkgconfig/opencv4.pc /usr/lib/pkgconfig
验证安装
1、检查 OpenCV 版本:
- pkgconfig modversion opencv4
2、测试 Python cv2 模块:
- python3 c "import cv2; print(cv2.__version__)"
以下是关于在 CentOS 上安装 OpenCV 的常见问题及解答:
Q1: 为什么在编译 OpenCV 时会出现错误?
A1: 编译 OpenCV 时出现错误可能有多种原因,包括但不限于缺少依赖项、CMake 配置不正确或网络问题导致下载失败,建议首先确保所有必要的依赖项都已安装,CMake 配置正确,如果问题仍然存在,可以查看CMakeDownloadLog.txt
文件以获取更多信息。
Q2: 如何卸载 OpenCV?
A2: 要卸载 OpenCV,可以删除相关的安装目录和库文件,如果 OpenCV 安装在/usr/local
目录下,可以使用以下命令卸载:
- sudo rm rf /usr/local/include/opencv4
- sudo rm rf /usr/local/lib64/libopencv*
- sudo rm rf /usr/local/share/opencv4
- sudo ldconfig
这只是一个示例路径,实际路径可能因安装选项而异。