PyQt5中List Widget无法在exec_all函数内添加Item问题求助

我写了一段简单的PyQt5代码，发现exec_all()函数里调用addItem()没法给UI里的List Widget添加项，但这个方法在其他地方用是正常的。相关代码片段如下：

from PyQt5 import QtWidgets, uic
from time import sleep

app = QtWidgets.QApplication([])
dlg = uic.loadUi("Program.ui")

def exec_all():
    dlg.OutputConsole.addItem("Test")
    web_scrap()
    # etc...

# web_scrap(): 另一个文件里的网页抓取函数，
# 有时需要等待HTML元素加载完成，用到了time.sleep()
def web_scrap(dlg):
    sleep(5)

dlg.RunAllButton.clicked.connect(exec_all)

dlg.show()
app.exec()

更新：我找到了问题根源——addItem()好像没法在后续调用sleep()前执行。难道addItem()是异步函数？是不是得替换web_scrap()里的sleep()方法才能解决问题？

核心原因是PyQt的UI更新依赖主线程的事件循环：你调用addItem()后，UI不会立刻刷新，而是要等当前函数执行完毕、主线程回到事件循环时，才会处理UI更新请求。但你紧接着调用sleep(5)会阻塞主线程，导致UI更新被卡住，直到sleep结束后才会一起执行。

addItem()本身不是异步函数，只是UI更新逻辑需要事件循环支持。解决问题必须替换sleep()，推荐两种靠谱方案：

方案1：用QTimer延迟执行 #

把需要等待后运行的逻辑放到QTimer的槽函数里，不会阻塞主线程，UI能正常更新：

from PyQt5.QtCore import QTimer

def exec_all():
    dlg.OutputConsole.addItem("Test")
    # 延迟5秒后调用web_scrap，期间主线程正常处理UI事件
    QTimer.singleShot(5000, lambda: web_scrap(dlg))

方案2：把耗时操作放到子线程 #

如果web_scrap()本身是耗时的网页抓取操作，更推荐用QThread把它放到子线程，彻底避免阻塞主线程：

from PyQt5.QtCore import QThread, pyqtSignal

class ScrapThread(QThread):
    # 可选：定义信号，用来通知主线程抓取完成（或传递结果）
    finished = pyqtSignal()

    def __init__(self, dlg):
        super().__init__()
        self.dlg = dlg

    def run(self):
        # 子线程中执行耗时的抓取逻辑
        sleep(5)
        self.finished.emit()

def exec_all():
    dlg.OutputConsole.addItem("Test")
    # 创建并启动子线程
    thread = ScrapThread(dlg)
    thread.finished.connect(lambda: print("抓取完成"))
    thread.start()

注意：绝对不能在子线程里直接操作UI控件，如果需要更新UI，必须通过信号槽机制让主线程处理。

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