### 编译适用于 Python 2 的 OpenCV (cv2) 库 为了在 Python 2 环境下成功编译 cv2 库，以下是详细的说明： #### 准备工作 确保已安装必要的依赖项。对于基于 Debian 或 Ubuntu 的 Linux 发行版，可以运行以下命令来安装所需的开发工具和库： ```bash sudo apt-get update && sudo apt-get upgrade sudo apt-get install build-essential cmake git libgtk2.0-dev pkg-config \ libavcodec-dev libavformat-dev libswscale-dev \ python-dev python-numpy libtbb2 libtbb-dev libjpeg-dev libpng-dev \ libtiff5-dev libjasper-dev libdc1394-22-dev ``` 这些依赖项涵盖了构建 OpenCV 所需的核心组件以及图像处理支持。 --- #### 创建虚拟环境 由于目标是针对 Python 2 进行配置，建议通过 `virtualenv` 来隔离环境并指定 Python 版本： ```bash virtualenv --system-site-packages -p /usr/bin/python2 ~/pyenv/py2_opencv source ~/pyenv/py2_opencv/bin/activate pip install numpy ``` 此操作会激活一个专门用于 Python 2 的虚拟环境，并安装 NumPy——这是 OpenCV 构建过程中必需的依赖[^1]。 --- #### 获取源码 下载最新版本的 OpenCV 和其贡献模块（opencv_contrib），或者选择特定版本以匹配需求： ```bash wget https://github.com/opencv/opencv/archive/<version>.zip unzip <version>.zip cd opencv-<version> mkdir build cd build ``` 同样地，获取 opencv_contrib 源码以便启用额外功能（可选）： ```bash wget https://github.com/opencv/opencv_contrib/archive/<version>.zip unzip <version>.zip ``` --- #### 使用 CMake 配置 执行 CMake 命令时，需要特别注意以下几个选项： - `-D PYTHON_DEFAULT_EXECUTABLE`: 指定当前使用的 Python 解释器路径。 - `-D PYTHON_NUMPY_INCLUDE_DIRS`: 提供 NumPy 头文件的位置。 - `-D PYTHON3_PACKAGES_PATH`: 设置 Python 包安装路径（尽管这里是 Python 2，仍需定义该变量）。 具体命令如下所示： ```bash cmake -D WITH_FFMPEG=ON \ -D WITH_IPP=OFF \ -D CMAKE_BUILD_TYPE=Release \ -D CMAKE_INSTALL_PREFIX=/path/to/installation/directory \ -D PYTHON_DEFAULT_EXECUTABLE=$(which python) \ -D PYTHON_NUMPY_INCLUDE_DIRS=$(python -c "import numpy; print(numpy.get_include())") \ -D PYTHON3_PACKAGES_PATH=$(python -c "from distutils.sysconfig import get_python_lib; print(get_python_lib())") .. ``` 此处需要注意的是，在 Python 2 中可能无法直接识别某些默认宏名称（如 `PYTHON3_...`）。因此，应手动调整为兼容模式[^2]。 --- #### 编译与安装 完成 CMake 配置后，继续进行实际编译过程： ```bash make -j$(nproc) sudo make install ``` 如果一切正常，则会在指定的目标目录中生成所需共享对象文件 `.so` 文件。将其复制至 Python 虚拟环境中的站点包路径即可加载模块： ```bash cp $(find . -name "*cv2*.so") $VIRTUAL_ENV/lib/python2.7/site-packages/ ``` --- #### 测试验证 进入 Python Shell 并尝试导入新编译好的库： ```python import cv2 print(cv2.__version__) ``` 如果没有错误提示且能够打印出版本号，则表明编译成功[^3]。 ---