You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何解决VSCode中Python3.8的OpenCV cv2 ModuleNotFoundError?

解决ModuleNotFoundError: No module named 'cv2'问题

针对你在VSCode+Python3.8环境下安装opencv-python后无法导入cv2的问题,按以下步骤排查:

  • 确认VSCode使用的Python解释器
    点击VSCode左下角显示的Python版本,选择你安装的Python3.8解释器(而非conda或其他版本)。也可以通过快捷键Ctrl+Shift+P打开命令面板,输入Python: Select Interpreter切换到目标版本。

  • 用Python3.8专属pip安装
    避免环境混装,直接用Python3.8的pip执行安装:

    # Windows
    python3.8 -m pip install opencv-python
    # macOS/Linux
    python3.8 -m pip install opencv-python
    

    若权限不足,Windows用管理员终端执行,macOS/Linux加sudo前缀。

  • 彻底清理残留的OpenCV包
    先卸载所有OpenCV相关包,确保无残留:

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

    再重新执行上面的安装命令。

  • 终端直接验证
    在VSCode终端输入python3.8进入交互模式,执行import cv2。如果这里成功,说明VSCode解释器未配置正确;如果仍报错,检查Python3.8是否正确添加到系统PATH,或重装Python3.8时勾选“Add Python to PATH”选项。

内容的提问来源于stack exchange,提问作者양이수

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.22 16:05:11