安装opencv后导入cv2报No module named 'cv2'如何解决

你遇到的导入失败核心原因是同时安装了4个互斥的OpenCV官方PyPI包，这几个包本身设计为四选一安装，共存时会相互覆盖文件，导致模块目录结构损坏，最终出现pip能查到安装记录、但Python无法识别cv2模块的问题。
四个包的互斥逻辑如下：

• opencv-python：带GUI功能的基础主包，包含OpenCV核心功能
• opencv-python-headless：去掉GUI依赖的基础主包，适配无桌面的服务器环境，和前者二选一
• opencv-contrib-python：带contrib扩展模块、带GUI功能的完整包，已经包含opencv-python的全部内容
• opencv-contrib-python-headless：带contrib扩展模块、无GUI的完整包，已经包含opencv-python-headless的全部内容

任意两个及以上上述包同时安装，都会触发文件冲突，你四个全装的情况下冲突完全覆盖了正常的cv2模块文件。

1. 彻底清理所有OpenCV残留包
   反复执行以下卸载命令，直到终端提示所有相关包都未安装：

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

   如果卸载后仍有残留，直接打开虚拟环境目录下的Lib\site-packages文件夹，手动删除所有文件名带opencv、cv2的文件夹，彻底清除损坏的残留文件。

2. 确认环境对应关系
   执行以下命令核对当前调用的pip、Python解释器路径：

   where pip
   where py
   

   返回的可执行文件路径必须是当前venv虚拟环境下Scripts目录内的文件，如果返回了全局Python的路径，说明虚拟环境激活失效，先执行venv目录下的Scripts\activate.bat重新激活，再核对路径。

3. 按需安装单个OpenCV包
   根据你的使用场景只选一个包安装，绝对不要同时装多个：

   • 桌面开发、不需要contrib扩展模块：执行pip install opencv-python
   • 桌面开发、需要SIFT/SURF等contrib扩展模块：执行pip install opencv-contrib-python
   • 服务器无GUI环境、不需要扩展模块：执行pip install opencv-python-headless
   • 服务器无GUI环境、需要contrib扩展模块：执行pip install opencv-contrib-python-headless

   你之前用的4.5.5.64版本和现有numpy 1.22.4完全兼容，可以指定版本安装避免版本问题，比如桌面开发用扩展模块的命令为：

   pip install opencv-contrib-python==4.5.5.64
   

4. 验证安装结果
   安装完成后先去Lib\site-packages确认存在cv2文件夹，再进入Python交互环境执行以下代码：

   import cv2
   print(cv2.__version__)
   

   正常输出版本号即修复完成。

• 只要在同一环境安装超过1个OpenCV相关包，大概率会出现导入报错、函数缺失等异常，安装时永远只选一个
• 如果按上述步骤操作后仍无法导入，直接删除当前损坏的venv文件夹，重新创建全新虚拟环境后再按步骤安装单个OpenCV包即可，不需要排查其他配置问题。

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