如何在 Python 中使用 QThread 结束线程

在 PyQt/PySide 应用程序中，使用 QThread 进行多线程编程是一种很常见的做法。对于刚刚入行的小白来说，理解如何结束线程是非常重要的一环。本篇文章将带你一步步了解如何实现 QThread 的简单结束。

流程概述

下表总结了结束 QThread 的主要步骤：

步骤 描述
1 创建一个 QThread 子类
2 定义线程的运行逻辑
3 启动线程
4 请求线程结束
5 在线程中处理结束请求
6 等待线程结束

步骤详解

1. 创建一个 QThread 子类

首先，我们需要创建一个继承自 QThread 的类。在这个类中，我们会重写 run() 方法，这是线程的主要执行代码。

from PyQt5.QtCore import QThread, pyqtSignal

class WorkerThread(QThread):
    # 定义一个信号，可以用于发送结束信号
    finished = pyqtSignal()

    def run(self):
        # 这是线程的主逻辑
        while True:
            # 执行一些操作
            print("Thread is running")
            # 模拟耗时操作
            self.msleep(100)  # 每次睡眠100ms

备注：msleep() 是 QThread 的方法，表示线程睡眠指定的毫秒数。

2. 定义线程的运行逻辑

在 run() 方法中，我们可以放置需要在新线程中执行的逻辑。这里，我们简单输出 "Thread is running"，并给线程一个短暂的睡眠时间以模拟正在执行的任务。

3. 启动线程

在主程序中，我们需要实例化 WorkerThread 类，然后启动这个线程。

if __name__ == "__main__":
    import sys
    from PyQt5.QtWidgets import QApplication

    app = QApplication(sys.argv)
    worker = WorkerThread()
    worker.start()  # 启动线程

4. 请求线程结束

为了安全地结束线程，我们可以在主线程中发送一个信号请求结束。

def stop_thread():
    worker.finished.emit()  # 发送结束信号

5. 在线程中处理结束请求

在 WorkerThread 类中，我们需要处理结束信号。我们可以通过连接信号和一个槽函数来处理这个逻辑。

class WorkerThread(QThread):
    finished = pyqtSignal()

    def __init__(self):
        super().__init__()
        self._running = True

    def run(self):
        while self._running:
            print("Thread is running")
            self.msleep(100)
            
    def stop(self):
        self._running = False  # 设置运行标志为 False
        self.finished.emit()   # 发送结束信号

6. 等待线程结束

在主程序中，可以使用 wait() 方法确保线程已经结束。

import time

def clean_up():
    worker.stop()  # 请求结束
    worker.wait()  # 等待线程结束

time.sleep(5)  # 主线程休眠，模拟一段执行过程
clean_up()     # 执行清理

完整示例代码

以下是整合以上步骤的完整代码示例：

from PyQt5.QtCore import QThread, pyqtSignal
from PyQt5.QtWidgets import QApplication
import time
import sys

class WorkerThread(QThread):
    finished = pyqtSignal()

    def __init__(self):
        super().__init__()
        self._running = True

    def run(self):
        while self._running:
            print("Thread is running")
            self.msleep(100)
    
    def stop(self):
        self._running = False
        self.finished.emit()

def main():
    app = QApplication(sys.argv)
    worker = WorkerThread()
    worker.start()  # 启动线程

    time.sleep(5)  # 主线程休眠模拟任务
    worker.stop()  # 请求结束线程
    worker.wait()  # 等待线程结束

if __name__ == "__main__":
    main()

结尾

通过以上步骤，你应该已经掌握了如何在 Python 中使用 QThread 创建和结束线程。记得在多线程编程中，安全地结束线程是非常重要的，以防止程序出现不可预测的行为。希望这篇文章对你在 PyQt/PySide 的学习中有所帮助！