VS Code中无法import cv2求助（Python 3.12.1版本）

问题描述 #

使用 Python 3.12.1 版本，尝试安装并导入 cv2 多次失败，已尝试以下命令：

• python -m pip install cv2
• pip install opencv-python

执行 import cv2 时报错：

>>> import cv2
Traceback (most recent call last):
  File "c:\Users\Admin\Music\file\nhandienkhuonmat.py", line 1, in <module>
    import cv2
ModuleNotFoundError: No module named 'cv2'

解决方案 #

• 确认 Python 与 pip 环境一致
  很多时候问题出在运行脚本的 Python 和安装包的 pip 不属于同一环境：

  • 查看当前 Python 路径：where python（Windows）/ which python（Linux/macOS）
  • 查看 pip 对应 Python 版本：pip --version
    若路径不匹配，用指定版本的 pip 安装：python3.12 -m pip install opencv-python

• 彻底卸载后重装
  先清理已安装的相关包：

  pip uninstall opencv-python opencv-contrib-python -y
  

  更新 pip 后重新安装：

  python -m pip install --upgrade pip
  python -m pip install opencv-python
  

• 检查虚拟环境状态
  如果使用了虚拟环境，必须先激活环境再操作：

  • Windows：venv\Scripts\activate
  • Linux/macOS：source venv/bin/activate

• 换国内镜像源安装（网络问题）
  若因网络导致安装不完整，用国内镜像加速：

  python -m pip install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple
  

内容的提问来源于stack exchange，提问作者Quang Thanh