PySide6无键鼠操作时重绘不更新问题求解

我发现在函数内尝试强制重绘时，只有移动鼠标或按下键盘按键才会生效。请问有没有办法无需任何键鼠事件就能实现重绘？

环境信息 #

系统：ArchLinux
Python版本：3.12.6
相关包版本：

$ pip list
Package            Version
------------------ -------
pip                24.2
PySide6            6.8.0.2
PySide6_Addons     6.8.0.2
PySide6_Essentials 6.8.0.2
shiboken6          6.8.0.2

最小复现代码 #

import sys
import random
import time
from PySide6 import QtCore, QtWidgets, QtGui

class MyWidget(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()

        self.button = QtWidgets.QPushButton("Click me!")
        self.layout = QtWidgets.QVBoxLayout(self)
        self.layout.addWidget(self.button)

        self.button.clicked.connect(self.magic)

    @QtCore.Slot()
    def magic(self):
        print("Change button")
        self.button.setText("I am sleeping")
        self.button.repaint()
        print("Label changed, sleep")
        time.sleep(2)
        self.button.setText("Click me!")
        print("Should be back to normal")


if __name__ == "__main__":
    app = QtWidgets.QApplication([])

    widget = MyWidget()
    widget.resize(200, 200)
    widget.show()

    sys.exit(app.exec())

问题现象 #

运行脚本后点击按钮，若点击后移动鼠标，按钮会显示“I am sleeping”；若不移动鼠标，按钮文本则保持“Click me!”。期望无需移动鼠标也能看到“I am sleeping”。

解决方案 #

问题根源是time.sleep(2)阻塞了Qt的主线程事件循环，导致重绘请求无法被处理——只有键鼠事件触发事件循环运转时，重绘才会执行。提供两种解决方法：

方法1：手动触发事件循环处理 #

在调用repaint()后，强制让应用处理当前所有待处理事件：

@QtCore.Slot()
def magic(self):
    print("Change button")
    self.button.setText("I am sleeping")
    self.button.repaint()
    # 强制处理所有待处理的UI事件
    QtWidgets.QApplication.processEvents()
    print("Label changed, sleep")
    time.sleep(2)
    self.button.setText("Click me!")
    print("Should be back to normal")

方法2：使用Qt定时器替代阻塞（推荐） #

改用QTimer延迟执行后续操作，避免阻塞主线程，让事件循环正常运转：

@QtCore.Slot()
def magic(self):
    print("Change button")
    self.button.setText("I am sleeping")
    # 禁用按钮防止重复点击
    self.button.setEnabled(False)
    # 2秒后执行恢复按钮状态的操作
    QtCore.QTimer.singleShot(2000, self.reset_button)

def reset_button(self):
    self.button.setText("Click me!")
    self.button.setEnabled(True)
    print("Should be back to normal")

方法2更符合Qt的异步编程模型，不会阻塞UI线程，是更优的解决方案。

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