PyQt5界面无响应的解决方案

更新时间：2024年05月09日 15:02:48 作者：Lorin洛林

如果在主线程执行耗时操作,比如循环、sleep、wait 异步线程执行会导致 UI 界面进入无响应状态,我们可以采用以下两种方式异步处理：使用QThread 或 QTimer,本文给大家介绍了PyQt5界面无响应的解决方案,需要的朋友可以参考下

前言

在PyQt5中，GUI线程通常指的是Qt的主事件循环线程，也称为主线程。主线程负责处理GUI事件、更新UI界面等任务。在PyQt5中，主线程和GUI线程是同一个线程，即运行应用程序的线程。
当创建一个Qt应用程序时，主线程会启动，并执行QApplication.exec_()方法，进入Qt的事件循环。在事件循环中，主线程会不断地监听并处理用户的输入事件、定时器事件、网络事件等，然后更新UI界面。
如果在主线程执行耗时操作，比如 循环、sleep、wait 异步线程执行 会导致 UI 界面进入无响应状态，我们可以采用以下两种方式异步处理：使用QThread 或 QTimer。

版本

PyQt5
Python 3.x

案例

我们写一个简单的进度条填充程序，每 2 秒填充 1%：

import sys
import time

from PyQt5.QtWidgets import QApplication, QWidget, QProgressBar, QPushButton, QHBoxLayout


class MyWidget(QWidget):
    def __init__(self):
        super(MyWidget, self).__init__()
        self.currentValue = 0

        self.progressBar = QProgressBar(self)
        self.progressBar.resize(200, 50)
        self.progressBar.move(20, 20)
        self.progressBar.setValue(self.currentValue)

        # 创建一个按钮
        self.button = QPushButton('点击我', self)
        self.button.clicked.connect(self.on_clicked)

        # 创建一个垂直布局，并将按钮添加到布局中
        layout = QHBoxLayout()
        layout.addWidget(self.progressBar)
        layout.addWidget(self.button)

        # 设置窗口的主布局为垂直布局
        self.setLayout(layout)

    def on_clicked(self):
        while True:
            time.sleep(2)
            self.currentValue = (self.currentValue + 1) % 101
            self.progressBar.setValue(self.currentValue)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    w = MyWidget()
    w.resize(500, 300)
    w.move(300, 300)
    w.setWindowTitle('Simple')
    w.show()
    sys.exit(app.exec_())

点击运行，我们会发现 UI 界面出现无响应且进度条没有刷新：

解决方案

为了避免 UI 界面无响应，我们可以采用以下两种方式：使用 QThread 或 QTimer。

QThread

我们可以通过点击事件创建 QThread 异步线程执行：

import sys
import time

from PyQt5.QtCore import QThread, pyqtSignal
from PyQt5.QtWidgets import QApplication, QWidget, QProgressBar, QPushButton, QHBoxLayout


class MyWorker(QThread):
    timeout = pyqtSignal()

    def __init__(self):
        super(MyWorker, self).__init__()

    def run(self):
        while True:
            time.sleep(2)
            self.timeout.emit()


class MyWidget(QWidget):
    def __init__(self):
        super(MyWidget, self).__init__()
        self.worker = None
        self.currentValue = 0

        self.progressBar = QProgressBar(self)
        self.progressBar.resize(200, 50)
        self.progressBar.move(20, 20)
        self.progressBar.setValue(self.currentValue)

        # 创建一个按钮
        self.button = QPushButton('点击我', self)
        self.button.clicked.connect(self.on_clicked)

        # 创建一个垂直布局，并将按钮添加到布局中
        layout = QHBoxLayout()
        layout.addWidget(self.progressBar)
        layout.addWidget(self.button)

        # 设置窗口的主布局为垂直布局
        self.setLayout(layout)

    def on_clicked(self):
        self.worker = MyWorker()
        self.worker.timeout.connect(self.upgradeProgress)
        self.worker.start()

    def upgradeProgress(self):
        self.currentValue = (self.currentValue + 1) % 101
        self.progressBar.setValue(self.currentValue)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    w = MyWidget()
    w.resize(500, 300)
    w.move(300, 300)
    w.setWindowTitle('Simple')
    w.show()
    sys.exit(app.exec_())

运行效果：

QTimer

我们可以通过点击事件创建 QTimer 定时器异步执行：

import sys
from PyQt5.QtCore import QTimer
from PyQt5.QtWidgets import QApplication, QWidget, QProgressBar, QPushButton, QHBoxLayout


class MyWidget(QWidget):
    def __init__(self):
        super(MyWidget, self).__init__()
        self.currentValue = 0

        self.progressBar = QProgressBar(self)
        self.progressBar.resize(200, 50)
        self.progressBar.move(20, 20)
        self.progressBar.setValue(self.currentValue)

        # 创建一个按钮
        self.button = QPushButton('点击我', self)
        self.button.clicked.connect(self.on_clicked)

        # 创建一个垂直布局，并将按钮添加到布局中
        layout = QHBoxLayout()
        layout.addWidget(self.progressBar)
        layout.addWidget(self.button)

        # 设置窗口的主布局为垂直布局
        self.setLayout(layout)

    def on_clicked(self):
        # 定义一个定时器并启动定时器
        self.time = QTimer()
        self.time.timeout.connect(self.upgradeProgress)
        self.time.start(200)

    def upgradeProgress(self):
        self.currentValue = (self.currentValue + 1) % 101
        self.progressBar.setValue(self.currentValue)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    w = MyWidget()
    w.resize(500, 300)
    w.move(300, 300)
    w.setWindowTitle('Simple')
    w.show()
    sys.exit(app.exec_())

运行效果：

局部变量创建异步线程导致 UI 未响应

在使用 QThread 的案例中，将 on_clicked 方法改为如下写法，同样会导致 UI 未响应状态：

    def on_clicked(self):
        worker = MyWorker()
        worker.timeout.connect(self.upgradeProgress)
        worker.start()

这是因为在Python中，类似于 worker = MyWorker() 这样的语句创建的对象在当前作用域中是局部变量，它的生命周期与当前作用域相关联。当当前作用域的代码执行完成后局部变量会被销毁。
如果异步线程的任务还没有完成，而主线程的事件循环又需要等待任务完成才能继续执行，那么就会导致GUI线程无响应。这是因为主线程被阻塞在等待异步任务的过程中，无法处理事件。
为了避免这种情况，我们应该将异步线程对象存储为实例变量（即使用 self.worker = MyWorker() ），这样可以确保异步线程对象的生命周期与主对象相同，直到异步任务完成。这样即使当前作用域的代码执行完成，异步线程仍然可以继续执行，并且主线程的事件循环也不会被阻塞。

如果 QTimer 不使用 self.time 写法

同理，如果不使用 self.time 写法，会被当做当前作用域中的局部变量，当前作用域代码执行完成后就会被销毁，不再继续执行。

到此这篇关于PyQt5界面无响应的解决方案的文章就介绍到这了,更多相关PyQt5界面无响应内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

对Python中内置异常层次结构详解
今天小编就为大家分享一篇对Python中内置异常层次结构详解，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-10-10
Python运算符的应用超全面详细教程
Python运算符是为了实现数值或字符运算的特殊符号。Python运算符可以分为算术运算符、逻辑运算符、赋值运算符、成员运算符、身份运算符、比较运算符、三目运算符等。接下来，我们就开始来学习这一堆符号吧
2022-07-07
Tensorflow2.1 完成权重或模型的保存和加载
这篇文章主要为大家介绍了Tensorflow2.1 完成权重或模型的保存和加载，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-11-11
Python使用pyinstaller打包含有gettext locales语言环境的项目(推荐)
最近在用 pyhton 做一个图片处理的小工具，顺便接触了gettext，用来实现本地化化中英文转换，本文通过一个项目给大家详细介绍下，感兴趣的朋友跟随小编一起看看吧
2022-01-01
Python 身份验证和授权库使用详解(python jwt库)
python_jwt是一个Python库，用于生成、解析和验证JSON Web Tokens（JWT），它完全符合JWT标准规范（RFC 7519），并提供了简单而强大的API，使得用户可以轻松地在Python应用中实现JWT功能，通过本文的介绍，深入探讨了python_jwt库的功能特性、使用方法以及应用场景
2021-01-01
用Python编写一个简单的Lisp解释器的教程
这篇文章主要介绍了用Python编写一个简单的Lisp解释器的教程,Lisp是一种源码简单的函数式编程语言,本文主要介绍对其中的一个子集Scheme的解释器开发,需要的朋友可以参考下
2015-04-04
Python函数参数基础介绍及示例
在声明函数的时候，一般会根据函数所要实现的功能来决定函数是否需要参数。在多数情况下，我们声明的函数都会使用到参数，这篇文章主要介绍了Python函数参数
2022-08-08
Tensorflow的常用矩阵生成方式
今天小编就为大家分享一篇Tensorflow的常用矩阵生成方式，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-01-01
在python3.5中使用OpenCV的实例讲解
下面小编就为大家分享一篇在python3.5中使用OpenCV的实例讲解，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-04-04
python3对拉勾数据进行可视化分析的方法详解
这篇文章主要给大家介绍了关于python3对拉勾数据进行可视化分析的相关资料，文中通过示例代码介绍的非常详细，对大家学习或者使用Python3具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-04-04