解决 ModuleNotFoundError: No module named 'cv2'

6 min read

ModuleNotFoundError: No module named 'cv2' 错误通常是由于编译 OpenCV 时未正确安装或未正确配置 OpenCV 环境变量引起的。建议按照以下步骤解决该错误：

  1. 确保已正确安装 OpenCV。

您可以通过以下命令检查是否已安装 OpenCV：

pip freeze | grep opencv-python

如果您看到 opencv-python 列表，则说明已安装 Opencv。

如果未找到 opencv-python，请尝试通过以下命令安装 OpenCV：

pip install opencv-python

注意：如果您正在使用虚拟环境，则应在虚拟环境中执行上述命令。

  1. 确保已正确配置 OpenCV 环境变量。

如果已正确安装 OpenCV，请确保已正确设置 OpenCV 环境变量。在 Windows 中，可以按照以下步骤设置环境变量：

  • 在 Windows 搜索栏中搜索“环境变量”并打开“编辑系统环境变量”。

  • 单击“环境变量”按钮，在用户变量或系统变量中添加以下路径：

    • （仅适用于 Windows 64 位）C:\opencv\build\x64\vc14\bin
    • （仅适用于 Windows 32 位）C:\opencv\build\x86\vc14\bin

  • 单击“确定”按钮以保存更改。

在 Linux 中，可以按照以下步骤设置环境变量：

  • 打开 .bashrc 文件：

    nano ~/.bashrc

  • 向文件最后添加以下路径：

    export PATH=$PATH:/usr/local/lib/python3.8/site-packages/cv2

  • 保存并退出文件，然后重新启动终端以使更改生效。

完成上述步骤后，您应该能够使用 cv2 模块。