macOS下Python Qt程序隐藏后暂停的原因排查及持续日志实现

• 系统后台进程节流：部分操作系统（如Windows、macOS）会在应用窗口不可见约45秒后，降低后台进程的CPU调度优先级，导致QRunnable所在的线程池线程被挂起，串口读取流程暂停。
• Qt线程池默认调度策略：QThreadPool的线程默认使用NormalPriority优先级，当应用进入后台状态后，系统会优先分配CPU资源给前台进程，后台线程的执行会被大幅延迟甚至暂停。
• 主线程事件循环节流：示例中通过信号将串口数据传递到主线程保存，若主线程因窗口隐藏进入事件循环节流状态，可能导致信号队列积压，间接影响子线程的执行节奏（尽管Qt信号为异步机制，但极端情况下会存在阻塞风险）。

• 改用QThread并设置高优先级：放弃QRunnable，使用独立的QThread创建串口日志线程，将线程优先级设为HighPriority，降低系统节流对其的影响：

import traceback
from PySide6.QtCore import QThread, Signal

class LogThread(QThread):
    result = Signal(dict)

    def run(self):
        try:
            while self.isRunning():
                result = self.getSerialData()  # 你的串口读取逻辑
                self.result.emit(result)
        except Exception:
            traceback.print_exc()

# 在MainWindow中初始化并启动线程
class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.log_thread = LogThread()
        self.log_thread.result.connect(self.updateLogData)
        self.log_thread.setPriority(QThread.HighPriority)
        self.log_thread.start()

    def updateLogData(self, result: dict):
        # 数据保存逻辑
        pass

• 子线程内直接完成日志持久化：避免依赖主线程，直接在子线程中完成串口数据读取与文件写入，完全脱离主线程事件循环的限制：

import json
import traceback
from PySide6.QtCore import QRunnable

class LogWorker(QRunnable):
    def run(self):
        try:
            # 打开日志文件，持续写入
            with open("serial_log.txt", "a", encoding="utf-8") as log_file:
                while True:
                    result = self.getSerialData()
                    log_file.write(json.dumps(result, ensure_ascii=False) + "\n")
                    log_file.flush()  # 强制刷新缓冲区，避免数据丢失
        except Exception:
            traceback.print_exc()

• 调整系统与Qt线程池配置：
  • 系统层面：Windows将电源模式设为「最佳性能」，macOS关闭「后台App刷新限制」与「自动节能模式」，减少系统对后台进程的资源限制。
  • Qt线程池：增大线程池最大线程数，并设置任务优先级：

from PySide6.QtCore import QThread

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.threadpool = QThreadPool.globalInstance()
        self.threadpool.setMaxThreadCount(2)  # 预留独立线程处理日志

    def startLog(self):
        log_worker = LogWorker()
        log_worker.setPriority(QThread.HighPriority)
        self.threadpool.start(log_worker)

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