调用animation.start()时changeColor()未触发的PySide6技术问题

你遇到的问题核心是跨线程直接调用Qt动画对象的方法：QVariantAnimation属于Qt的QObject子类，所有UI相关操作（包括动画的启动和信号处理）必须在主线程（UI线程）执行。子线程直接调用startFade()时，动画的事件无法被主线程的事件循环处理，导致valueChanged信号根本不会触发；而用QEventLoop包裹的方式虽然能触发动画，但会阻塞主线程的事件循环，导致整个程序卡死。

解决方案：用Qt信号槽实现跨线程通信 #

Qt的信号槽机制天生支持跨线程安全通信，当信号在子线程发射、槽函数在主线程绑定的情况下，会自动把事件放入主线程的事件队列处理，既不会阻塞线程，又能保证动画在UI线程正常运行。

修正后的FadeItem类代码

from PySide6.QtCore import *
from PySide6.QtWidgets import *

class FadeItem(QTableWidgetItem):
    # 定义自定义信号，用于从子线程触发动画启动
    fadeRequested = Signal()

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.animation = QVariantAnimation()
        self.animation.setStartValue(QColor.fromRgb(193, 0, 193))
        self.animation.setEndValue(QColor.fromRgb(193, 0, 193, 0))
        self.animation.setDuration(300)
        self.animation.setEasingCurve(QEasingCurve.InBack)
        self.animation.valueChanged.connect(self.changeColor)
        # 将自定义信号与启动动画的方法绑定
        self.fadeRequested.connect(self.startFade)
    
    def changeColor(self, color):
        print(color)
        self.setBackground(color)

    def startFade(self):
        self.animation.stop()
        self.animation.start()

子线程调用示例

在子线程中不要直接调用startFade()，而是发射fadeRequested信号：

class WorkerThread(QThread):
    def __init__(self, target_item):
        super().__init__()
        self.target_item = target_item

    def run(self):
        # 模拟子线程的耗时操作（比如数据加载、计算）
        self.sleep(1)
        # 发射信号，让主线程处理动画启动
        self.target_item.fadeRequested.emit()

主程序使用示例

if __name__ == "__main__":
    app = QApplication([])
    table = QTableWidget()
    table.setRowCount(1)
    table.setColumnCount(1)
    test_item = FadeItem("测试单元格")
    table.setItem(0, 0, test_item)
    table.show()

    # 启动子线程，触发动画
    worker = WorkerThread(test_item)
    worker.start()

    app.exec()

原理说明 #

当子线程发射fadeRequested信号时，Qt会自动使用QueuedConnection（默认跨线程连接方式）将信号事件放入主线程的事件队列。主线程的事件循环处理这个事件时，会在UI线程中调用startFade()，此时动画的启动和valueChanged信号的处理都处于主线程，既能正常触发渐变效果，又不会阻塞程序运行。

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