点击QTreeWidget项时使用QThread防止界面冻结的正确实现方法

• 初始版本卡顿的核心原因：time.sleep(2) 这类高负载耗时逻辑直接运行在Qt主线程（GUI事件循环线程），阻塞了界面绘制、交互响应的事件处理，导致点击后界面完全冻结，直到耗时任务结束才会恢复响应。
• 你参考教程写的测试版本存在4个明确问题，无法正常运行：
  1. 作用域错误：change_text 方法中直接调用 item.text(0)，但 item 是 tree_click 方法的局部参数，change_text 执行时该变量已超出作用域，会触发未定义错误。
  2. 冗余定义：Worker 类中重复声明了两次 finished = pyqtSignal()。
  3. 线程安全违规：没有通过信号槽做跨线程数据传递，逻辑上试图直接跨线程访问GUI对象，Qt的GUI组件非线程安全，这类写法会引发随机崩溃、界面异常。
  4. 资源泄漏：每次点击都新建QThread和Worker对象，没有做生命周期绑定，重复点击会生成大量孤立线程和对象，占用内存不释放。

Qt官方推荐的 moveToThread 写法遵循两个核心原则：所有GUI操作只能在主线程执行，耗时逻辑全部放在子线程的Worker对象中，跨线程通信只使用信号槽。以下是可直接运行的正确实现：

from PyQt5.QtWidgets import *
from PyQt5.QtCore import *
import time

class Worker(QObject):
    # 任务完成信号：将处理结果以字符串形式传回主线程
    task_finished = pyqtSignal(str)

    @pyqtSlot(str)
    def do_long_task(self, item_text):
        # 此处放所有高负载耗时逻辑，禁止操作任何GUI控件
        time.sleep(2)
        # 任务执行完成后，通过信号发送结果
        self.task_finished.emit(item_text)

class MyTreeWidget(QTreeWidget):
    def __init__(self):
        super().__init__()
        item_1 = QTreeWidgetItem()
        item_1.setText(0, 'one item')
        item_2 = QTreeWidgetItem()
        item_2.setText(0, 'another item')
        self.addTopLevelItem(item_1)
        item_1.addChild(item_2)
        self.setHeaderHidden(True)

class MainWindow(QMainWindow):
    # 触发子线程任务的信号，传递字符串类型参数
    start_long_task = pyqtSignal(str)

    def __init__(self):
        super().__init__()
        self.setWindowTitle('MainWindow')
        self.layout = QVBoxLayout()
        
        self.treewidget = MyTreeWidget()
        self.treewidget.itemClicked.connect(self.tree_click)
        self.layout.addWidget(self.treewidget)
        
        self.label = QLabel("Label", self)
        self.layout.addWidget(self.label)
        
        widget = QWidget()
        widget.setLayout(self.layout)
        self.setCentralWidget(widget)

        # 初始化时一次性创建线程和工作对象，复用线程避免频繁创建销毁的开销
        self.worker_thread = QThread()
        self.worker = Worker()
        self.worker.moveToThread(self.worker_thread)
        
        # 绑定信号槽
        self.start_long_task.connect(self.worker.do_long_task)
        self.worker.task_finished.connect(self.update_label)
        self.worker_thread.finished.connect(self.worker.deleteLater)
        self.worker_thread.finished.connect(self.worker_thread.deleteLater)
        
        self.worker_thread.start()
        self.show()

    @pyqtSlot(QTreeWidgetItem)
    def tree_click(self, item):
        # 主线程仅执行轻量操作：提取需要的纯文本数据，发信号触发子线程任务
        clicked_text = item.text(0)
        self.start_long_task.emit(clicked_text)

    @pyqtSlot(str)
    def update_label(self, text):
        # 仅在主线程操作GUI控件更新界面
        self.label.setText(text)

if __name__ == '__main__':
    import sys
    app = QApplication(sys.argv)
    main = MainWindow()
    sys.exit(app.exec())

• 绝对禁止在子线程中直接调用任何GUI组件的方法（包括QLabel、QTreeWidgetItem等所有界面相关对象），否则会出现偶发崩溃、界面绘制错乱的问题。
• 跨线程传递数据优先使用Python基础类型（字符串、数字、布尔值、普通列表/字典等），不要将GUI对象直接传递到子线程。
• Qt的信号槽跨线程通信时会自动使用队列连接，是内置的线程安全通信方式，不需要手动加锁。
• 如果存在用户快速连续点击条目的场景，可以在Worker中增加任务状态标记，上一个任务未执行完时忽略新的任务请求，避免任务堆积。

内容的提问来源于stack exchange，提问作者温泽海