WSL2+VSCode环境下OpenCV imshow首次运行正常、后续调用闪退问题咨询

这个问题我之前在WSL2环境里折腾OpenCV时也碰到过，大概率是两个核心原因叠加导致的，给你拆解下：

核心原因 #

1. OpenCV窗口资源未正确释放：第一次运行后，你只调用了cv2.waitKey(0)但没清理窗口资源，残留的窗口会话会干扰下一次程序运行，导致新窗口无法正常停留。
2. WSL2的X服务器会话残留/配置问题：WSL2本身没有原生GUI，依赖X服务器（比如VcXsrv、X410）显示窗口。第一次连接正常后，后续可能因为X服务器的访问控制、DISPLAY环境变量异常，导致窗口一闪而过。

具体解决方案 #

1. 强制清理OpenCV窗口资源 #

修改你的代码，在cv2.waitKey(0)之后加上cv2.destroyAllWindows()，确保每次运行结束都彻底释放窗口资源：

image = cv2.imread('sample.png')
cv2.imshow('image', image)
cv2.waitKey(0)
cv2.destroyAllWindows()  # 新增这行，彻底销毁所有OpenCV窗口

这是解决该问题最直接的方法，绝大多数情况下加这一行就能搞定。

2. 检查X服务器配置 #

如果加了销毁代码还是不行，那大概率是X服务器的问题：

• 启动X服务器（比如VcXsrv）时，一定要勾选Disable access control选项，否则WSL后续的连接会被拒绝，窗口直接闪退。
• 确认WSL里的DISPLAY环境变量正确：在终端输入echo $DISPLAY，应该输出类似localhost:0.0或者你的Windows主机IP加:0.0。如果不对，手动设置：

  export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0.0
  

  可以把这行命令添加到~/.bashrc或~/.zshrc里，每次打开终端自动加载。

3. 清理残留进程 #

如果上述方法都无效，试试杀掉残留的Python/OpenCV进程：

pkill -9 python3  # 或者根据你的Python版本用python

之后再重新运行程序，应该就能正常显示窗口了。

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