PyQt中点击一次实现QTreeWidget清空并显示内容的问题

你的核心问题是耗时任务阻塞了主线程，导致Qt的事件循环无法处理界面重绘，所以"Wait..."文本来不及显示就被后续操作覆盖，同时界面卡顿。QTreeWidget的clear()方法本身就是批量清空所有条目，完全适合上万条数据的场景，不用逐个删除，重点要把耗时的文件夹遍历任务移到子线程执行，避免阻塞主线程。

解决方案：使用QThread分离耗时任务 #

把耗时的逻辑放到独立线程中，通过Qt的信号槽机制在子线程和主线程间传递数据，保证主线程始终能处理界面更新。

修改后的完整代码：

import sys
import time
from PyQt5.QtWidgets import (QApplication, QTreeWidgetItem, QPushButton, 
                             QTreeWidget, QVBoxLayout, QWidget)
from PyQt5.QtCore import QThread, pyqtSignal

class WorkerThread(QThread):
    # 定义信号，用于传递生成的条目数据
    result_ready = pyqtSignal(list)

    def run(self):
        items_data = []
        # 模拟耗时的文件夹遍历任务
        for i in range(0, 5):
            print(i)
            time.sleep(.3)
        
        # 实际场景中替换为真实的文件列表生成逻辑
        items_data = [["Item 1"], ["Item 2"], ["Item 3"], ["Item 4"], ["Item 5"], ["Item 6"]]
        # 发送结果到主线程
        self.result_ready.emit(items_data)

class AppDemo(QWidget):
    def __init__(self):
        super().__init__()
        self.layout = QVBoxLayout()
        self.resize(500,700)
        self.tree = QTreeWidget()
        self.tree.setHeaderLabels(['Name', 'Date', 'Size', 'Path'])

        self.button = QPushButton("Button", self)
        self.layout.addWidget(self.button)
        self.layout.addWidget(self.tree)
        
        self.button.clicked.connect(self.start_process)

        # 初始化工作线程
        self.worker = WorkerThread()
        self.worker.result_ready.connect(self.update_tree_with_result)
        self.worker.finished.connect(self.worker.deleteLater)  # 线程结束后释放资源

        self.setLayout(self.layout)
        self.show()

    def start_process(self):
        # 清空树并显示等待提示
        self.tree.clear()
        wait_item = QTreeWidgetItem(["Wait...................."])
        self.tree.insertTopLevelItem(0, wait_item)
        # 启动耗时任务线程
        self.worker.start()
    
    def update_tree_with_result(self, items_data):
        # 接收线程传递的结果，更新树控件
        self.tree.clear()
        items = [QTreeWidgetItem(data) for data in items_data]
        self.tree.insertTopLevelItems(0, items)

# 初始化应用
app = QApplication(sys.argv)
demo = AppDemo()
app.exec_()

关键改动说明： #

• 新增WorkerThread类继承自QThread，把耗时的文件遍历逻辑放到run()方法中，执行完成后通过result_ready信号把数据传递给主线程。
• 主线程的start_process函数只负责界面操作：清空树、显示等待提示，然后启动子线程，不执行任何耗时操作，保证界面能及时更新。
• 通过result_ready信号连接到update_tree_with_result函数，在主线程中更新树控件（Qt要求界面操作必须在主线程执行）。
• 线程结束后调用deleteLater()释放资源，避免内存泄漏。

这样修改后，点击按钮就能立刻看到"Wait..."提示，同时后台执行耗时任务，任务完成后自动更新树控件，全程界面不会卡顿。

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