适用于 PYNQ-Z2 的 OpenCV 包版本需要根据其硬件和软件环境进行选择。PYNQ-Z2 基于 Xilinx ZYNQ-7000 FPGA 平台，支持通过 Python 编程实现 APSoC 功能[^2]。通常情况下，PYNQ-Z2 使用的 OpenCV 版本为 3.x 或 4.x 系列，具体取决于所安装的 PYNQ 版本及其依赖的软件栈。 在实际应用中，xfOpenCV 是一个更优的选择，因为它是 Xilinx 提供的硬件加速版本 OpenCV，能够显著提升图像处理性能[^1]。如果用户希望使用标准 OpenCV 而非硬件加速版本，则需要确保安装的 OpenCV 版本与目标平台的操作系统和 Python 环境兼容。例如，在基于 Ubuntu 的 PYNQ 环境中，推荐使用以下命令安装 OpenCV： ```bash sudo apt-get update sudo apt-get install python3-opencv ``` 上述命令将安装与当前系统匹配的 OpenCV 版本。对于 PYNQ-Z2 默认的 Ubuntu 18.04 环境，这通常会安装 OpenCV 3.2 或更高版本[^2]。 如果需要手动编译 OpenCV 以支持特定功能或优化性能，可以参考以下步骤： 1. 下载 OpenCV 源码（推荐版本为 4.5.x）。 2. 配置编译选项以启用必要的模块和支持的硬件加速。 3. 使用 CMake 工具生成 Makefile，并执行编译过程。 以下是手动编译 OpenCV 的示例代码块： ```bash # 安装依赖项 sudo apt-get install -y build-essential cmake git pkg-config libjpeg-dev libtiff5-dev libjasper-dev libpng-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libxvidcore-dev libx264-dev libgtk-3-dev libatlas-base-dev gfortran # 克隆 OpenCV 源码 git clone https://github.com/opencv/opencv.git cd opencv git checkout 4.5.5 # 根据需求选择合适的版本 # 创建构建目录 mkdir build && cd build # 配置编译选项 cmake -D CMAKE_BUILD_TYPE=RELEASE \ -D CMAKE_INSTALL_PREFIX=/usr/local \ -D WITH_FFMPEG=ON \ -D WITH_V4L=ON \ -D WITH_TBB=ON \ -D WITH_GTK=ON \ -D BUILD_EXAMPLES=ON .. # 编译并安装 make -j$(nproc) sudo make install ``` 完成安装后，可以通过以下 Python 代码验证 OpenCV 是否正确加载： ```python import cv2 print(cv2.__version__) ```