macOS环境Python3中按q键无法关闭OpenCV窗口该如何解决？

问题原因 #

• 平台兼容差异：macOS的OpenCV HighGUI模块事件循环逻辑与Windows/Linux不同，cv2.waitKey()只有在OpenCV窗口处于激活状态时才能捕获键盘输入，若当前焦点在Spyder控制台，按键事件会被Spyder优先截获，无法传递到OpenCV窗口。
• 版本兼容性bug：OpenCV 4.5.3对macOS High Sierra的GUI渲染适配存在缺陷，cv2.destroyWindow()执行后，GUI线程无法正确释放窗口资源，会出现主程序已经运行结束但窗口卡在最后一帧的情况。
• IDE事件冲突：Spyder 5的内置控制台基于Qt框架实现，和OpenCV的HighGUI事件循环存在抢占，导致窗口销毁指令无法被正确执行。

解决方案 #

方案1：修改代码增加兼容逻辑 #

在原有代码的末尾添加多轮cv2.waitKey()调用，处理未完成的GUI事件，修改后完整收尾代码如下：

cap.release()
cv2.destroyWindow(window_name)
# 新增macOS兼容逻辑
for _ in range(5):
    cv2.waitKey(1)
cv2.destroyAllWindows()
for _ in range(5):
    cv2.waitKey(1)

方案2：调整窗口触发操作 #

代码运行后先点击OpenCV弹出的预览窗口，确保窗口处于激活状态后再按q键，即可正常触发退出逻辑。

方案3：优化按键检测逻辑 #

延长waitKey的等待时长，同时增加ESC键作为备选退出触发键，将原循环内的判断代码修改为：

# 原代码：if cv2.waitKey(1) & 0xFF == ord('q'):
# 替换为：
if cv2.waitKey(10) & 0xFF in [ord('q'), 27]:

方案4：绕过Spyder环境运行 #

如果上述方案都无效，可以直接打开macOS自带的终端，进入代码所在目录后执行python3 代码文件名.py运行程序，完全规避Spyder的事件循环冲突，该方案可解决绝大多数同类问题。

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