已将慢运行代码移至QThread，为何GUI仍卡顿？

一、确认代码是否真的在子线程执行 #

• 在正则搜索代码的关键位置添加线程ID打印，对比GUI线程ID，验证代码是否真正运行在子线程：

  import threading
  from PyQt5.QtCore import QThread
  
  # 在sleep循环和正则代码前后分别打印
  print(f"sleep阶段线程ID: {threading.get_ident()}, GUI线程ID: {QThread.currentThreadId()}")
  # ... 正则搜索代码 ...
  print(f"正则阶段线程ID: {threading.get_ident()}")
  

  如果正则阶段的线程ID和GUI线程ID一致，说明moveToThread用法有误（比如直接在主线程调用了工作对象的方法，而非通过信号触发）。

二、检查是否存在主线程阻塞操作 #

• 禁止子线程操作GUI：如果正则代码里有更新UI控件、调用QWidget方法的逻辑，哪怕是间接调用，都会强制转到主线程执行，直接导致卡顿。确保子线程只处理纯逻辑，UI更新通过信号槽传递给主线程。
• 排查全局锁冲突：某些正则库或依赖模块可能使用了全局线程锁，导致子线程与主线程抢锁，主线程被阻塞。可以单独测试正则代码的线程安全性，比如用多线程同时跑正则，观察是否出现阻塞。

三、使用工具定位卡顿根源 #

• PyQt内置栈打印：在正则代码执行时，分别给主线程和子线程打印调用栈，查看主线程是否在等待子线程的同步操作：

  # 子线程内打印栈
  QThread.dumpStack()
  # 主线程通过定时器触发打印
  from PyQt5.QtCore import QTimer
  QTimer.singleShot(1000, QThread.dumpStack)
  

• py-spy采样分析：用第三方工具py-spy实时监控线程状态（无需修改代码）：
  1. 安装：pip install py-spy
  2. 运行：py-spy top --pid <你的进程ID>
     该工具会显示所有线程的CPU占用和调用栈，能直接看到主线程是否卡在等待逻辑，或是子线程CPU占用过高导致主线程得不到时间片。
• cProfile性能剖析：针对正则代码做性能分析，找出耗时热点：

  import cProfile
  cProfile.runctx("你的正则搜索函数()", globals(), locals(), "profile_results.prof")
  

  用snakeviz可视化结果：snakeviz profile_results.prof，查看正则表达式的哪部分最耗时，针对性优化（比如减少回溯、预编译正则对象re.compile()）。

四、检查moveToThread的用法正确性 #

确保代码符合标准范式，避免直接在主线程调用工作对象的慢方法：

from PyQt5.QtCore import QObject, QThread, pyqtSignal

class Worker(QObject):
    finished = pyqtSignal()

    def do_work(self):
        # 这里放慢运行代码（正则搜索等）
        self.finished.emit()

# 主线程中创建线程和工作对象
thread = QThread()
worker = Worker()
worker.moveToThread(thread)
thread.started.connect(worker.do_work)
worker.finished.connect(thread.quit)
worker.finished.connect(worker.deleteLater)
thread.finished.connect(thread.deleteLater)

# 通过启动线程触发工作，而非直接调用worker.do_work()
thread.start()

五、排查GUI窗口创建的线程归属 #

新GUI窗口必须在主线程创建，子线程只能处理逻辑。若你在子线程中创建窗口，本身违反Qt的线程规则，会导致异常卡顿。确保所有UI控件的创建、显示都在主线程完成。

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