PySide6手动光标动画多线程失效：静止光标不更新求助

问题根源 #

• 主线程中使用time.sleep()会阻塞UI事件循环，导致界面卡死，无法响应用户操作。
• 多线程中直接调用setCursor()违反Qt的线程安全规则，UI操作必须在主线程执行，非主线程的UI修改不会立即触发系统更新光标状态，只有鼠标移出再移入控件时才会触发刷新。

推荐方案：使用QTimer实现无阻塞光标切换 #

QTimer是Qt专门用于定时任务的类，运行在主线程中，不会阻塞UI，能实时触发光标更新：

import sys
from PySide6.QtCore import *
from PySide6.QtGui import *
from PySide6.QtWidgets import *

class Window(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.label1 = QLabel("QTimer实现")
        self.label1.mouseReleaseEvent = self.start_cursor_animation
        
        layout = QHBoxLayout(self)
        layout.addWidget(self.label1)

        # 初始化定时器和光标状态
        self.cursor_timer = QTimer(self)
        self.cursor_timer.timeout.connect(self.toggle_cursor)
        self.is_wait_cursor = False
        self.animation_count = 0

    def start_cursor_animation(self, event):
        print("Label clicked, starting cursor animation")
        # 重置计数并启动定时器，每1秒切换一次
        self.animation_count = 0
        self.cursor_timer.start(1000)

    def toggle_cursor(self):
        if self.animation_count >= 10:
            self.cursor_timer.stop()
            return
        
        # 切换光标
        if self.is_wait_cursor:
            self.label1.setCursor(Qt.CursorShape.CrossCursor)
            print("Cursor set to CrossCursor")
        else:
            self.label1.setCursor(Qt.CursorShape.WaitCursor)
            print("Cursor set to WaitCursor")
        
        self.is_wait_cursor = not self.is_wait_cursor
        self.animation_count += 1

if __name__ == "__main__": 
    app = QApplication(sys.argv)
    window = Window()
    window.show()
    sys.exit(app.exec())

备选方案：多线程+信号槽（线程安全版） #

如果一定要用线程处理复杂逻辑，必须通过信号槽机制让主线程执行光标更新操作，因为Qt禁止非主线程直接操作UI：

import sys
import time
from PySide6.QtCore import *
from PySide6.QtGui import *
from PySide6.QtWidgets import *

class CursorWorker(QRunnable):
    def __init__(self, signal):
        super().__init__()
        self.toggle_signal = signal

    def run(self):
        for _ in range(10):
            # 发送信号通知主线程切换为WaitCursor
            self.toggle_signal.emit(True)
            time.sleep(1)
            # 发送信号通知主线程切换为CrossCursor
            self.toggle_signal.emit(False)
            time.sleep(1)

class Window(QWidget):
    # 定义信号，参数为布尔值，标记要切换的光标类型
    toggle_cursor = Signal(bool)

    def __init__(self, parent=None):
        super().__init__(parent)
        self.label2 = QLabel("多线程+信号槽实现")
        self.label2.mouseReleaseEvent = self.start_multithread_animation
        
        layout = QHBoxLayout(self)
        layout.addWidget(self.label2)

        self.threadpool = QThreadPool()
        # 绑定信号到光标切换函数
        self.toggle_cursor.connect(self.update_cursor)

    def start_multithread_animation(self, event):
        print("Label clicked, starting multithread cursor animation")
        worker = CursorWorker(self.toggle_cursor)
        self.threadpool.start(worker)

    def update_cursor(self, is_wait_cursor):
        # 该函数在主线程执行，安全修改光标
        if is_wait_cursor:
            self.label2.setCursor(Qt.CursorShape.WaitCursor)
            print("Cursor set to WaitCursor")
        else:
            self.label2.setCursor(Qt.CursorShape.CrossCursor)
            print("Cursor set to CrossCursor")

if __name__ == "__main__": 
    app = QApplication(sys.argv)
    window = Window()
    window.show()
    sys.exit(app.exec())

关键说明 #

• Qt的所有UI操作必须在主线程执行，任何非主线程的UI修改都会导致不可预期的问题。
• QTimer是处理UI定时任务的最优选择，无需额外线程，避免线程安全问题。
• 若使用线程，必须通过信号槽将UI操作委托给主线程，这是Qt线程间通信的标准方式。

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