OpenCV调用imshow()函数弹出未响应窗口该如何解决？

1. 验证图片读取有效性 #

cv2.imread读取文件失败时会返回None，直接将空值传入cv2.imshow会触发窗口无响应故障，优先添加读取校验排查路径问题：

import cv2

img = cv2.imread('hand.png')
if img is None:
    print("图片读取失败，请检查：文件路径是否正确、路径是否包含中文/特殊字符、当前运行工作目录是否与图片存放目录匹配")
else:
    cv2.imshow('Hand',img)
    # 注意：弹出窗口后需先点击窗口使其激活，再按任意键关闭
    cv2.waitKey(0)
    cv2.destroyAllWindows()

2. 排查OpenCV包兼容性与冲突 #

• 执行命令检查已安装的OpenCV相关包：
  Windows环境：pip list | findstr opencv
  Linux/macOS环境：pip list | grep opencv
• 如果同时安装了opencv-python和opencv-python-headless，需卸载无GUI支持的headless版本：pip uninstall opencv-python-headless
• 可尝试更换兼容版本验证：pip install opencv-python==4.5.5.62，该版本与Python3.9的适配性已被广泛验证

3. 排除运行环境影响 #

• 窗口焦点问题：cv2.waitKey(0)仅能捕获处于激活状态的imshow窗口的按键输入，若弹出窗口后未点击激活窗口，直接在IDE控制台按按键不会触发窗口关闭，看起来就会显示未响应
• 可尝试直接在系统自带终端（cmd/命令行/终端）运行脚本，排除IDE交互环境的限制
• 若在Jupyter Notebook类的网页交互环境运行，OpenCV原生imshow适配性较差，建议改用matplotlib.pyplot.imshow展示图片
• Linux环境需先安装必要的GUI依赖：sudo apt install libgtk2.0-dev libglib2.0-dev
• 可运行下方测试代码排除图片本身问题：

import cv2
import numpy as np
# 生成测试用空白图
test_img = np.zeros((400, 400, 3), dtype=np.uint8)
cv2.putText(test_img, "Test Success", (80, 200), cv2.FONT_HERSHEY_SIMPLEX, 1, (0, 255, 0), 2)
cv2.imshow("TestWindow", test_img)
cv2.waitKey(0)
cv2.destroyAllWindows()

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