PyQt5按钮点击打开顶级窗口偶发重复触发问题咨询

嘿，这个问题我之前也碰到过！其实核心是窗口焦点切换时的事件冲突搞的鬼，具体原因是这样的：

• 当你点击按钮弹出新窗口，且新窗口完全覆盖原窗口时，系统窗口管理器和Qt的事件处理会出现一个小bug：按钮的clicked信号触发后，原窗口立刻失去焦点，新窗口在获取焦点的瞬间，鼠标点击的位置刚好落在新窗口上，但系统会误把这次点击再次传递给原窗口的按钮，导致clicked信号被触发了第二次，于是就多弹出了一个窗口。
• 简单说就是，焦点切换的间隙里，鼠标点击事件被重复处理了，这种情况在窗口完全覆盖时更容易发生，因为新窗口刚好接住点击的同时，原窗口的事件队列还残留了未处理的信号。

给你几个实用的解决方案：

1. 给窗口弹出加个短延迟 #

让焦点切换完成后再创建窗口，避免事件冲突，用QTimer加个100ms左右的延迟就够了：

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

class foo(QWidget):
    def __init__(self):
        super().__init__()
        self.widgets = []
        self.button = QPushButton("Bar")
        self.button.clicked.connect(self.baz)
        layout = QHBoxLayout()
        layout.addWidget(self.button)
        self.setLayout(layout)
        
    def baz(self):
        # 延迟100ms执行窗口创建
        QTimer.singleShot(100, self._create_window)

    def _create_window(self):
        w = QWidget()
        w.show()
        self.widgets.append(w)
        print(len(self.widgets))

if __name__ == "__main__":
    app = QApplication([])
    f = foo()
    f.show()
    app.exec_()

2. 点击后临时禁用按钮 #

点击按钮后先把它禁用，等窗口创建完成再启用，从根源上防止重复触发：

def baz(self):
    button = self.sender()
    button.setEnabled(False)  # 禁用按钮
    w = QWidget()
    w.show()
    self.widgets.append(w)
    print(len(self.widgets))
    button.setEnabled(True)  # 重新启用按钮

3. 使用单次触发的信号连接 #

如果这个按钮只需要触发一次窗口弹出，可以用单次连接模式，确保信号只执行一次：

# 在初始化按钮的时候修改连接方式
from PyQt5.QtCore import Qt
self.button.clicked.connect(self.baz, Qt.SingleShotConnection)

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