为什么cv.waitKey(0)未在按键按下前暂停程序执行？

核心原因 #

你遇到的cv.waitKey(0)直接返回的问题，核心是该函数是OpenCV HighGUI模块的专属事件处理函数，必须绑定至少一个已创建的HighGUI窗口才能正常工作，无窗口时会直接返回-1，不会进入等待逻辑。

底层机制说明 #

• cv.waitKey的设计目标是驱动HighGUI的事件循环，负责处理窗口重绘、键盘鼠标输入、窗口交互等事件，并非通用的程序暂停/键盘输入接口
• 当不存在任何活跃的HighGUI窗口时，cv.waitKey会跳过事件等待逻辑，无论传入的delay参数是多少，都会立刻返回-1，这就是你当前代码直接执行完成的原因

修复示例 #

只需要提前创建一个空的HighGUI窗口即可让cv.waitKey正常工作，不需要实际显示图像：

import cv2 as cv

print("Start")
# 创建一个占位窗口，可设置为隐藏属性不干扰界面
cv.namedWindow("DummyWindow", cv.WINDOW_HIDDEN)
k = cv.waitKey(0)
print("Stop")
# 用完销毁占位窗口
cv.destroyAllWindows()

针对眼动仪回调阻塞问题的建议 #

你排查的回调阻塞问题和cv.waitKey的阻塞特性直接相关：

• cv.waitKey(delay)会阻塞当前线程直到超时或检测到按键输入，如果设置delay为0会无限阻塞当前线程，必然会阻塞同线程内的眼动仪回调执行
• 建议将delay设置为1~10ms的短值，每次cv.waitKey处理完窗口事件后立刻返回，留出时间片执行眼动仪的回调逻辑，示例如下：

# run_flag为自定义的程序运行标记
while run_flag:
    # 仅阻塞1ms处理窗口事件
    key = cv.waitKey(1)
    if key == ord('q'):
        break
    # 此处处理眼动仪回调相关逻辑，不会被长期阻塞

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