PySide(Qt)主窗口离屏时事件循环停滞，如何维持事件处理？

核心原因 #

Qt默认会对不可见/处于后台虚拟终端的窗口启用资源优化，降低甚至暂停主线程事件循环的处理优先级，以此节省系统资源，但这会阻断后台需要持续运行的跨组件交互逻辑。

可行解决方案 #

1. 全局禁用Qt的后台事件暂停优化 #

通过QApplication的属性设置直接关闭该优化，这是最直接的解决方式：

from PySide6.QtWidgets import QApplication
from PySide6.QtCore import Qt

app = QApplication([])
# 禁用窗口后台时的事件处理限制
app.setAttribute(Qt.ApplicationAttribute.AA_NativeWindows, True)

也可以针对单个主窗口设置属性，避免影响全局：

main_window.setAttribute(Qt.WidgetAttribute.WA_ShowWithoutActivating, True)

2. 用低优先级定时器维持事件循环活跃 #

如果全局属性设置无效，可在主线程添加一个空定时器，定期触发事件循环：

from PySide6.QtCore import QTimer

# 在主窗口初始化方法中添加
self.keep_alive_timer = QTimer(self)
self.keep_alive_timer.setInterval(100)  # 每100ms触发一次空事件
self.keep_alive_timer.timeout.connect(lambda: None)
self.keep_alive_timer.start()

3. 确保信号连接的队列类型 #

显式指定线程信号与主线程槽函数的连接类型为QueuedConnection，避免信号因事件循环停滞而积压：

from PySide6.QtCore import Qt

# 工作线程信号连接主线程槽函数时显式指定队列连接
worker_thread.message_received.connect(main_thread_handler, Qt.ConnectionType.QueuedConnection)

4. 排查系统级后台限制 #

部分Linux桌面环境（如GNOME、KDE）会对后台窗口进程设置资源限制，可在系统设置中关闭对应窗口的"后台暂停"或"节能优化"选项。

注意事项 #

• 优先使用第一种方案，这是Qt官方提供的配置方式，资源消耗最低。
• 保持原设计逻辑：工作线程仅负责消息检测，所有跨组件操作由主线程执行，避免线程安全问题。

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