PyCharm中OpenCV无代码提示且报NoneType无shape属性错误

一、解决AttributeError: 'NoneType' object has no attribute 'shape'错误 #

这个错误的核心是cv2.imread(args["image"])返回了None，说明程序未成功读取到图片，常见原因及解决方法：

• 检查图片路径准确性
  命令行传递的-i参数路径需确保无误：
  • 若用相对路径，要保证路径对应PyCharm的运行工作目录（可通过底部终端查看当前路径，或在Run/Debug配置中指定工作目录）
  • 优先使用绝对路径，比如-i "C:/Users/xxx/Pictures/test.jpg"（Windows路径用斜杠/或双反斜杠\\）
• 验证图片文件状态
  • 确认图片未损坏，可尝试用系统自带图片查看器打开
  • 确保图片格式为OpenCV支持类型（如JPG、PNG，特殊格式需先转换）
• 检查命令行参数配置
  在PyCharm的Run/Debug配置中，需在Program arguments栏填写-i "你的图片路径"，直接运行脚本会因缺少参数导致读取失败

二、解决PyCharm中CV2无函数提示的问题 #

结合你的环境（Python3.11、opencv-python4.7.0.72、Windows11、PyCharm），可尝试以下方案：

• 确认PyCharm解释器配置
  打开File > Settings > Project: [你的项目名] > Python Interpreter，检查列表中是否存在opencv-python；若没有，点击+搜索安装，或切换至正确的虚拟环境/全局解释器
• 安装opencv-contrib-python补充类型提示
  在终端执行：

  pip install opencv-contrib-python==4.7.0.72
  

  该包包含完整的类型定义文件，可帮助PyCharm识别函数提示
• 清除PyCharm缓存并重启
  点击File > Invalidate Caches...，选择Invalidate and Restart，强制PyCharm重新加载依赖的类型信息
• 手动标记opencv目录为源码根（可选）
  若以上方法无效，找到opencv安装目录（如Lib/site-packages/cv2），右键该目录选择Mark Directory as > Sources Root

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