PyQt5中运行方法时禁用按钮以防止重复点击的实现方案

你的代码中，runner方法里的while循环是在主线程中执行的。PyQt的UI更新和事件处理都依赖主线程，当主线程被耗时的循环占用时，按钮的禁用状态无法立即刷新，点击事件也会被积压到循环结束后才处理，所以出现了按钮在循环期间仍可点击、方法被反复触发的问题。

把耗时的循环逻辑放到独立子线程执行，让主线程专注处理UI更新和事件响应，这样就能及时禁用按钮，避免重复触发。

修改后的代码 #

from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton
from PyQt5.QtCore import QThread, pyqtSignal
import sys


class Worker(QThread):
    # 定义信号，用于通知主线程任务完成
    finished = pyqtSignal()

    def run(self):
        # 这里放置耗时操作
        i = 0
        while i < 5000000:
            i += 1
            print(i, end=" ")
        # 任务完成后发送信号
        self.finished.emit()


class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Demo")
        self.button = QPushButton("Press me!")
        self.button.clicked.connect(self.start_task)
        self.setCentralWidget(self.button)
        
        # 初始化工作线程
        self.worker = Worker()
        # 连接线程完成信号到启用按钮的方法
        self.worker.finished.connect(self.on_task_finished)

    def start_task(self):
        # 点击按钮后立即禁用并更新文本
        self.button.setText("Running...")
        self.button.setEnabled(False)
        # 启动子线程执行任务
        self.worker.start()

    def on_task_finished(self):
        # 任务完成后恢复按钮状态并更新UI
        self.button.setText("Press me!")
        self.button.setEnabled(True)
        self.setWindowTitle("Changed title")


app = QApplication(sys.argv)
window = MainWindow()
window.show()
app.exec()

关键说明 #

1. Worker线程类：继承QThread，将耗时循环逻辑放在run方法中，任务完成时通过finished信号通知主线程。
2. 主线程控制UI：点击按钮时立即禁用按钮并启动子线程，子线程完成后通过信号触发主线程更新UI、恢复按钮状态。
3. 线程安全：子线程不能直接操作UI元素，必须通过信号让主线程处理UI更新，这是PyQt的线程安全要求。

备选方案：使用processEvents（不推荐） #

如果是简单场景，也可以在循环中插入QApplication.processEvents()强制处理UI事件，但这种方式本质还是阻塞主线程，容易导致事件循环混乱，仅适合临时调试：

def runner(self):
    self.button.setEnabled(False)
    self.button.setText("Running...")
    i = 0
    while i < 5000000:
        i += 1
        print(i, end=" ")
        # 强制处理UI事件
        QApplication.processEvents()
    self.button.setEnabled(True)
    self.button.setText("Press me!")

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