PyCharm安装opencv-contrib-python后报cv2无read属性错误如何解决

核心报错原因 #

module 'cv2.cv2' has no attribute 'read'的触发原因是调用了OpenCV不存在的内置接口，同时代码中还有两处会引发后续报错的逻辑问题，逐一修正即可正常运行。 #

具体问题修正 #

• 修正图像读取接口的错误方法名
  • OpenCV没有cv2.read()这个内置方法，读取本地图像的正确接口是cv2.imread()，这就是当前报错的直接来源。
  • 你代码里传入的参数('101_7.png', 0)是符合接口要求的：0代表以单通道灰度模式读入图像，不需要修改参数值，仅替换方法名即可。
• 修正imshow接口的参数缺失问题
  • cv2.imshow()必须传入两个必填参数：第一个是自定义的窗口名称字符串，第二个是需要展示的图像矩阵。你当前代码只传了图像参数，就算修复了读取的报错，也会立刻触发参数数量不匹配的错误。
  • 图像弹窗需要配合键盘等待逻辑才能正常展示，否则运行时窗口会一闪而过，看不到处理结果。

修正后可直接运行的完整代码 #

import cv2

if __name__ == '__main__':
    # 替换为正确的图像读取方法
    im = cv2.imread('101_7.png', 0)
    # 增加读取失败校验，避免路径错误导致空矩阵报错
    if im is None:
        print("图像读取失败，请确认101_7.png文件路径是否正确")
    equ = cv2.GaussianBlur(im, (5, 5), 0)
    # 补全imshow的窗口名称参数
    cv2.imshow("高斯模糊处理结果", equ)
    # 阻塞等待任意键盘按键，触发后关闭所有弹窗
    cv2.waitKey(0)
    cv2.destroyAllWindows()

环境排查提示 #

如果修改接口后仍然提示cv2缺少对应属性，需要核对PyCharm当前选中的运行解释器，和你安装opencv-contrib-python的环境是否一致，避免出现PyCharm调用了系统默认Python环境、未安装对应依赖的情况。

可以在终端中输入python -c "import cv2; print(cv2.__version__)"核对当前环境下的OpenCV安装状态。

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