树莓派ModuleNotFoundError: No module named 'cv2'

### 解决树莓派上安装 OpenCV 时遇到的 `ModuleNotFoundError`

当在树莓派上尝试导入 `cv2` 模块并收到 `ModuleNotFoundError: No module named 'cv2'` 错误时，这通常意味着尚未正确安装 OpenCV 库。以下是详细的解决方案：

#### 环境准备

确保 Python 和 pip 是最新版本，可以通过以下命令更新它们：

sudo apt-get update
sudo apt-get upgrade python3-pip

#### 安装依赖项

为了使 OpenCV 正常工作，需先安装一些必要的系统级依赖项：

sudo apt-get install libjpeg-dev libtiff5-dev libjasper-dev libpng12-dev
sudo apt-get install libavcodec-dev libavformat-dev libswscale-dev libv4l-dev
sudo apt-get install libxvidcore-dev libx264-dev
sudo apt-get install qt4-dev-tools libatlas-base-dev

#### 使用 pip 安装 OpenCV-Python

通过 pip 来安装官方预编译好的二进制文件是最简单的方法之一：

pip3 install opencv-python-headless

如果希望获得完整的功能支持（包括 GUI 功能），则应改为安装带有图形界面组件的版本：

pip3 install opencv-python

对于某些情况下可能出现的 `skbuild` 缺失问题[^3]，建议提前单独安装此构建工具链的支持包：

pip3 install scikit-build

完成上述操作后再次测试是否可以正常引入 `cv2` 模块。