如何解决VS Code中ModuleNotFoundError: No module named 'cv2'问题

问题场景 #

CMD中可正常导入cv2，Python版本为3.11.3 64位，cv2版本4.7.0，但VS Code切换到同版本解释器后仍报错ModuleNotFoundError: No module named 'cv2'

排查解决步骤 #

• 核对VS Code与CMD的Python解释器路径

  1. 在CMD执行where python，复制输出的完整Python路径（例如C:\Python311\python.exe）
  2. 点击VS Code左下角的解释器名称，选择「Enter interpreter path...」，粘贴上述路径并确认

• 检查终端环境一致性
  如果CMD中使用了虚拟环境，需在VS Code的终端中激活对应环境：

  venv\Scripts\activate  # Windows系统虚拟环境激活命令
  

• 重新定向安装cv2到当前解释器
  在VS Code的终端直接执行：

  pip install opencv-python
  

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