在 Ubuntu 20.04 系统中安装 `opencv-contrib-python` 包，可以通过 Python 的包管理工具 `pip` 直接进行安装。该包包含 OpenCV 的官方扩展模块（包括额外的算法和功能），适用于大多数开发需求。 ### 安装步骤 1. **更新系统包列表** 在终端执行以下命令以确保系统软件包是最新的： ```bash sudo apt update ``` 2. **安装 Python 和 pip（如果尚未安装）** 确保系统中已安装 Python 及其对应的 `pip` 工具： ```bash sudo apt install python3 python3-pip ``` 3. **安装 opencv-contrib-python 包** 使用以下命令通过 `pip` 安装 `opencv-contrib-python`： ```bash pip3 install opencv-contrib-python ``` 如果需要指定特定版本，例如与 OpenCV 4.5.2 兼容的版本，可以使用如下命令： ```bash pip3 install opencv-contrib-python==4.5.2.52 ``` 4. **验证安装是否成功** 安装完成后，运行以下命令检查 OpenCV 版本并确认是否导入正常： ```bash python3 -c "import cv2; print(cv2.__version__)" ``` 输出结果应显示当前安装的 OpenCV 版本号，如 `4.5.2` 或更高版本。 ### 手动编译安装说明（可选） 如果用户希望从源码构建带有 `opencv_contrib` 模块的 OpenCV，并将其用于 Python 开发环境，可参考引用[2]中的编译流程。主要步骤如下： 1. 克隆 OpenCV 及其扩展模块仓库： ```bash git clone https://github.com/opencv/opencv.git git clone https://github.com/opencv/opencv_contrib.git ``` 2. 创建构建目录并配置 CMake 参数： ```bash cd opencv mkdir build && cd build cmake -D CMAKE_BUILD_TYPE=RELEASE \ -D CMAKE_INSTALL_PREFIX=/usr/local \ -D OPENCV_EXTRA_MODULES_PATH=../../opencv_contrib/modules \ -D BUILD_opencv_python3=ON \ -D PYTHON_DEFAULT_EXECUTABLE=$(which python3) \ -D WITH_FFMPEG=ON .. ``` 3. 编译并安装： ```bash make -j$(nproc) sudo make install ``` 4. 更新动态链接库缓存并设置 Python 路径： ```bash sudo ldconfig export PYTHONPATH="$PYTHONPATH:/usr/local/lib/python3.8/site-packages" ``` 5. 验证安装： ```bash python3 -c "import cv2; print(cv2.__version__)" ``` ### 注意事项 - 如果遇到共享库缺失问题（如 `libopencv_core.so.3.2: cannot open shared object file`），可通过重新安装 OpenCV 并确保正确配置 `LD_LIBRARY_PATH` 来解决。 - 对于 Anaconda 用户，建议在虚拟环境中安装 `opencv-contrib-python` 以避免依赖冲突： ```bash conda activate your_env_name pip install opencv-contrib-python ``` ###