### 在 Ubuntu 24.04 上搭建 OpenCV 开发环境 #### 准备工作 在开始之前，确保已经更新系统的软件包列表并升级现有软件包到最新版本。可以运行以下命令完成此操作： ```bash sudo apt update && sudo apt upgrade -y ``` #### 安装依赖项 为了成功编译和安装 OpenCV，需要先安装必要的依赖库。执行以下命令来安装这些依赖项： ```bash sudo apt install build-essential cmake git pkg-config libgtk-3-dev \ libavcodec-dev libavformat-dev libswscale-dev libv4l-dev \ libxvidcore-dev libx264-dev libjpeg-dev libpng-dev libtiff-dev \ gfortran openexr libatlas-base-dev python3-dev python3-numpy \ libtbb2 libtbb-dev libdc1394-22-dev ``` 上述命令涵盖了构建工具、图像处理库以及 Python 支持所需的组件[^1]。 #### 下载 OpenCV 和 OpenCV Contrib 库 通过 Git 克隆官方仓库获取最新的源码文件。进入用户的主目录后执行如下命令下载所需资源： ```bash cd ~ git clone https://github.com/opencv/opencv.git git clone https://github.com/opencv/opencv_contrib.git ``` 这一步会将核心的 OpenCV 功能及其附加模块存储至本地磁盘以便后续使用。 #### 配置 CMake 构建选项 创建一个新的文件夹用于存放生成的目标文件，并切换至此路径下设置特定参数以定制化安装过程： ```bash mkdir -p ~/opencv/build && cd ~/opencv/build cmake -D CMAKE_BUILD_TYPE=RELEASE \ -D CMAKE_INSTALL_PREFIX=/usr/local \ -D OPENCV_EXTRA_MODULES_PATH=~/opencv_contrib/modules .. ``` 这里指定了额外的功能模块位置（`OPENCV_EXTRA_MODULES_PATH`），从而启用更多高级特性支持。 #### 编译与安装 启动多线程模式加速整个编译流程；完成后将其复制到系统标准库路径当中去供全局访问调用： ```bash make -j$(nproc) sudo make install sudo ldconfig ``` 利用 `ldconfig` 更新动态链接器缓存使得新加入的内容立即生效。 #### 使用 VCPKG 进行简化管理 (可选方法) 如果倾向于采用更简便的方式，则可以通过微软提供的跨平台C++包管理器——vcpkg 来快速部署指定版本号下的 opencv 及其扩展插件集组合方案： ```powershell .\vcpkg integrate install vcpkg install opencv4[contrib,nonfree] ``` 注意该方式适用于 Windows PowerShell 或 Linux Shell 环境中的脚本自动化场景，在某些特殊情况下可能无法完全替代传统手动配置手段[^2]。 #### 测试安装成果 编写简单的测试程序验证当前环境下是否能够正常加载 library 并实现基础功能演示效果为例证说明正确性： 保存下面这段代码为 test_opencv.py 文件形式存在任意地方即可运行查看结果反馈情况如何。 ```python import cv2 print("OpenCV version:", cv2.__version__) image = cv2.imread('example.jpg') if image is not None: cv2.imshow('Image', image) cv2.waitKey(0) else: print("Failed to load image.") ``` 确保有适当权限读取图片素材的前提下应该可以看到窗口弹出显示画面内容或者打印错误提示信息出来作为依据判断依据。 ---