Windows10 Anaconda tf-gpu环境下如何彻底卸载OpenCV解决功能报错

问题原因 #

你遇到的报错是因为当前环境中安装的是无GUI支持的OpenCV开发（dev）版本，且存在多路径安装的残留文件，导致常规卸载/重装操作无法覆盖生效。

修复步骤 #

1. 定位残留OpenCV文件 #

先激活你的tf-gpuconda环境，在环境内启动Python或者Jupyter Notebook，运行以下代码获取当前导入的cv2实际安装路径：

import cv2
print(cv2.__file__)

输出路径示例：C:\ProgramData\Anaconda3\envs\tf-gpu\Lib\site-packages\cv2\__init__.py
根据输出路径，找到上层的cv2文件夹，以及同目录下所有opencv开头的.dist-info/.egg-info文件夹，手动全部删除。

2. 执行干净重装 #

回到激活tf-gpu环境的终端，先确认当前使用的pip属于目标环境，避免装到base或者全局环境：

where pip

确认返回的第一个路径在你的tf-gpu环境目录下后，执行清理和安装命令：

# 彻底卸载残留包
pip uninstall opencv-python opencv-contrib-python -y
conda uninstall opencv opencv-python -y
# 安装带完整GUI支持的正式版OpenCV
pip install opencv-python==4.5.5.62 opencv-contrib-python==4.5.5.62

3. 验证修复 #

重启Jupyter Notebook内核（必须重启清除之前的模块缓存），运行测试代码：

import cv2
# 确认版本不是dev版
print(cv2.__version__)
# 测试GUI功能
cap = cv2.VideoCapture(0)
ret, frame = cap.read()
if ret:
    cv2.imshow("test", frame)
    cv2.waitKey(0)
    cv2.destroyAllWindows()
cap.release()

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