PyCharm中cv2包无函数提示且运行imshow时报断言错误

问题1：输入cv2.时IDE无函数自动提示 #

• 核心原因：PyCharm的代码索引未绑定到实际安装OpenCV的Python解释器路径
• 排查操作：
  • 打开PyCharm设置，进入Project: [当前项目名] > Python Interpreter配置页
  • 确认当前选中的解释器的已安装包列表中，存在版本匹配的opencv-python包（对应报错日志里的4.4.0版本），如果缺失就在该解释器下完成对应版本安装
  • 若已安装包仍无提示，点击配置页的「Show All」选项，选中当前使用的解释器，点击顶部的「Show Interpreter Paths」按钮，确认路径列表中包含OpenCV包所在的site-packages目录，缺失则手动添加
  • 等待PyCharm完成全量代码索引重建（右下角会显示索引进度），完成后即可正常触发cv2下的函数自动补全

问题2：运行时抛出size.width>0 && size.height>0断言错误 #

• 错误本质：cv2.imshow接收的图像对象为空，说明前序cv2.imread未成功读取到图片，图像宽高为0触发OpenCV内置的校验断言
• 排查操作：
  • 先在cv2.imshow代码前添加打印语句print(type(img), img)，如果输出结果是<class 'NoneType'>，即可确认是图片读取失败的问题
  • 常见触发场景与解法：
    • 相对路径不匹配：代码中写的"Resources/0017.png"是相对于PyCharm运行工作目录的路径，默认工作目录为项目根目录，需确认：
      • 项目根目录下是否真的存在名为Resources的文件夹（注意文件名字母大小写，跨平台环境下大小写区分会导致路径匹配失败）
      • 文件夹内的图片文件名是否完全匹配，避免出现后缀名写错（比如实际是0017.jpg）、文件名带隐藏空格等问题
    • 路径特殊字符导致读取失败：如果图片所在路径包含中文、空格字符，直接写相对路径可能出现读取静默失败，可先替换为无特殊字符的绝对路径（比如r"D:\project\Resources\0017.png"）测试读取是否正常
  • 代码优化建议：cv2.imread读取失败时不会主动抛错，只会静默返回None，建议在读取后增加非空校验，避免报模糊的imshow错误，示例代码：

    import cv2
    img = cv2.imread("Resources/0017.png")
    if img is None:
        raise FileNotFoundError("未找到对应图片，请检查路径配置")
    cv2.imshow('Window', img)
    cv2.waitKey(0)
    cv2.destroyAllWindows()
    

  • 补全代码提醒：仅写cv2.imshow不加cv2.waitKey(0)会导致图像窗口无响应、直接闪退，排查时容易和当前的读取报错混淆

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