Mac版VSCode运行OpenCV代码无报错但不显示图像如何解决

首先明确：cv2.imshow() 是调用系统原生GUI接口弹出独立窗口显示图像，不需要安装VSCode专属扩展即可正常工作，无报错但不显示窗口可以按以下顺序排查：

• 首先修正代码缩进与逻辑问题
  你贴出的代码存在Python缩进错误，cv2.destroyAllWindows() 属于if判断内的执行语句，必须保持统一缩进；另外要保证cv2.waitKey(0) 必须和cv2.imshow()在同一执行流中，waitKey是OpenCV GUI事件的唯一刷新入口，缺了它窗口不会完成渲染。修正后的参考代码如下：

  kernel = cv2.getStructuringElement(cv2.MORPH_ELLIPSE, (7, 7))
  opening = cv2.morphologyEx(dist, cv2.MORPH_OPEN, kernel)
  # 可取消下一行注释，打印确认输入的图像数据合法
  # print(opening.shape, opening.dtype)
  cv2.imshow("Opening", opening)
  k = cv2.waitKey(0)
  if k == 27 or k == ord('q'):
      cv2.destroyAllWindows()
  

  额外要确认传入cv2.imshow的opening变量是非空的合法numpy数组，如果前面的dist变量（距离变换输出）本身计算异常得到空值，也会导致窗口无法正常渲染。

• 检查OpenCV安装包版本
  如果你安装的是无GUI的headless版本OpenCV，会默认砍掉所有highgui弹窗相关功能，运行imshow不会抛错但也不会弹出窗口，执行以下命令重装正确版本即可：

  pip uninstall -y opencv-python-headless
  pip install --force-reinstall opencv-python
  

  安装完成后重启VSCode的终端会话再运行代码。

• 匹配你的VSCode运行场景
  如果你是通过VSCode远程连接WSL、SSH服务器跑代码，本地默认无法直接接收远程环境的GUI弹窗，这种情况不需要折腾X11转发的话，可以直接换matplotlib库渲染图像，图像会直接内嵌显示在VSCode的交互式面板中：

  import matplotlib.pyplot as plt
  plt.imshow(opening, cmap='gray')
  plt.title("Opening")
  plt.show()
  

  如果你是在Jupyter单元格里分段跑代码，要把imshow、waitKey、窗口销毁的逻辑放在同一个单元格执行，拆分到不同单元格会导致窗口刚创建就被销毁，无法正常显示。

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