ModuleNotFoundError: No module named 'cv2' ubuntu

### 解决方案

在Ubuntu系统中遇到`ModuleNotFoundError: No module named 'cv2'`错误表明当前环境中未正确安装OpenCV库。为了修复这个问题，可以按照以下方法来安装所需的依赖项和OpenCV Python包[^1]。

#### 安装前准备

确保系统的软件包索引是最新的：

sudo apt update

对于某些版本的Ubuntu，建议先安装必要的开发工具和其他依赖关系，这有助于构建过程顺利进行并减少潜在的问题：

sudo apt-get install build-essential cmake git pkg-config libgtk-3-dev \
libavcodec-dev libavformat-dev libswscale-dev python3-dev python3-numpy \
libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev

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

最简单的方法是通过Python的包管理器pip直接安装预编译好的二进制文件。这种方法适用于大多数情况，并能快速解决问题[^3]。

首先确认已安装最新版pip:

python3 -m pip install --upgrade pip

接着执行如下命令以安装官方发布的稳定版OpenCV-Python绑定：

python3 -m pip install opencv-python

如果还需要额外的功能比如contrib模块，则可继续安装opencv-contrib-python：

python3 -m pip install opencv-contrib-python

以上操作完成后应该能够成功导入cv2模块而不再报错。值得注意的是，在虚拟环境中工作时要确保上述指令是在激活后的环境下运行的[^2]。