已安装opencv-python但PyCharm调用cv2报ModuleNotFound错误求助

1. 核对Python解释器匹配性 #

这是最常见的问题，你在cmd中用pip安装依赖的Python环境，和PyCharm当前项目使用的解释器不属于同一个。

• 先在cmd执行命令查看pip绑定的环境路径：
  pip --version
  输出会明确标注当前pip对应的Python安装目录，记录下这个路径。
• 打开PyCharm项目的解释器设置：依次进入 文件 > 设置 > 项目:<你的项目名称> > Python 解释器，查看顶部显示的解释器路径是否和你刚才记录的路径一致：
  • 路径不一致：点击解释器右侧的齿轮图标选择「添加」，找到你刚才记录路径下的python.exe，确认后切换为该解释器即可。
  • 路径一致：直接点击当前解释器依赖列表下方的「+」按钮，搜索opencv-python后直接在PyCharm内完成安装，重启项目即可生效。

2. 解决虚拟环境隔离问题 #

如果你创建项目时勾选了「为项目创建虚拟环境」，项目默认会使用独立的虚拟环境，全局pip安装的依赖不会同步到该环境中：

• 方案一：在PyCharm底部打开「终端」面板，直接执行pip install opencv-python，该终端默认加载当前项目的虚拟环境，安装完成后即可正常导入cv2。
• 方案二：不需要使用虚拟环境的话，直接在解释器设置中切换为全局Python解释器即可。

3. 修复安装包异常 #

如果上述操作都无效，可能是安装包本身损坏，执行如下命令重装即可：

1. 先卸载所有相关包：
   pip uninstall -y opencv-python opencv-python-headless
2. 重新执行安装：
   pip install opencv-python
3. 重启PyCharm后再次测试导入。

额外注意事项 #

• 不要将你的Python脚本或者项目根目录命名为cv2.py、opencv.py，会和官方库名冲突导致导入失败。
• 安装完成后如果还是报错，尝试点击PyCharm的 文件 > 无效缓存并重启，清除缓存后重新加载项目。

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