Pygame开发游戏时关闭窗口后Python进程无响应无法正常退出

常见触发场景 #

• 未捕获系统级窗口关闭事件
  绝大多数这类问题的根源是主循环没有处理pygame.QUIT事件。当用户点击窗口右上角的关闭按钮时，系统会直接销毁窗口UI元素，但如果主循环没有轮询事件队列、没有识别到QUIT事件触发自定义的terminate流程，程序不会主动走到退出逻辑，进程会卡在后台空转，表现为“未响应”。即使所有主动写的按钮退出逻辑都正常调用了terminate，只要漏了对系统窗口关闭事件的处理，点叉号关闭窗口时就一定会出现进程驻留的问题。这也是为什么之前尝试修改terminate内部的退出顺序、替换退出语句写法都没有效果的核心原因——修改的代码根本没有在点窗口关闭时被执行到。
• Pygame子系统资源未完全释放
  仅调用pygame.quit()只是向所有Pygame关联的子系统发送通用退出信号，部分关联的资源句柄如果没有单独清理，会阻塞进程退出流程：
  • 正在播放的音频流、打开的mixer通道没有主动停止和释放
  • 硬件加速的渲染上下文没有在退出前主动销毁
  • 加载的大体积Surface资源没有被垃圾回收机制及时回收
    这些场景下即使执行了sys.exit()，进程也会卡在资源回收的等待环节，不会立刻终止。
• 主循环逻辑阻塞事件处理流程
  如果主循环把事件轮询的逻辑放在了物理计算、帧渲染等耗时逻辑的后面，用户点击关闭窗口时，系统会先销毁窗口UI，再把QUIT事件放入队列，但此时主循环还在执行之前的长耗时计算，等计算完成读取事件队列时，对应的QUIT事件已经被系统清除，程序会进入无窗口、无事件响应的空转状态，直接显示为“未响应”。
• 非守护状态的后台线程阻塞
  如果代码中启动了资源加载、数据同步等后台线程，但没有将线程设置为守护线程，这些线程会在主线程触发退出流程时继续运行，一旦线程卡在IO等待、循环空转的状态，整个Python进程会一直等待这些线程执行完成，无法正常终止。

对应排查与解决方法 #

• 调整主循环的逻辑顺序，将事件轮询和QUIT事件判断放在主循环的第一优先级：

  while True:
      # 事件处理最高优先级，不要放在耗时逻辑之后
      for event in pygame.event.get():
          if event.type == pygame.QUIT:
              terminate()
          # 其余按键、鼠标交互逻辑
      # 后续写帧绘制、物理计算等耗时逻辑
  

• 优化terminate函数的清理顺序，保证所有子系统资源被主动释放：

  def terminate():
      # 先停止所有音频播放，释放混音器资源
      pygame.mixer.stop()
      pygame.mixer.quit()
      # 主动销毁显示渲染上下文
      pygame.display.quit()
      # 退出所有Pygame关联子系统
      pygame.quit()
      # 触发正常进程退出
      sys.exit(0)
  

• 排查所有自定义启动的后台线程，将不需要在退出时保留运行的线程设置为守护线程，避免阻塞主进程退出。

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