PySide2组件抢占键盘后Raspbian系统下主窗口无法移动问题咨询

这是Qt框架针对X11平台（Raspbian默认使用X11窗口系统）的适配bug，而非你的代码逻辑问题。Windows平台未复现是因为Windows的输入抢占机制和X11不同，Qt在Windows平台的这部分逻辑没有兼容性问题。

• grabKeyboard()的作用是全局抢占所有键盘输入到目标控件，在X11环境下，点击菜单栏触发菜单弹出时，Qt会临时给弹出的菜单申请输入抢占，抢占结束后原本QLineEdit的键盘抢占状态没有正确和窗口管理器的输入焦点状态同步，导致窗口管理器收不到拖动窗口标题栏的鼠标事件对应的焦点确认，最终触发窗口无法拖动的问题。

方案1：动态切换键盘抢占状态（最稳妥，无感知） #

在菜单弹出、关闭的节点主动释放和重新抢占键盘，完全不影响原有功能，修改后代码如下：

#!/usr/bin/env python3

from PySide2.QtWidgets import QApplication, QMainWindow, QAction, QLineEdit

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.line_edit = None
        menu = self.menuBar()
        start_menu = menu.addMenu("Start")
        # 绑定菜单弹出、关闭的信号到对应处理函数
        start_menu.aboutToShow.connect(self.release_keyboard)
        start_menu.aboutToHide.connect(self.grab_keyboard)

        action = QAction("Test", self)
        action.triggered.connect(self.test)
        start_menu.addAction(action)

        self.line_edit = QLineEdit()
        self.line_edit.grabKeyboard()

        self.setCentralWidget(self.line_edit)
    
    def release_keyboard(self):
        if self.line_edit:
            self.line_edit.releaseKeyboard()
    
    def grab_keyboard(self):
        if self.line_edit:
            self.line_edit.grabKeyboard()

    def test(self):
        print("clicked")

if __name__ == "__main__":
    app = QApplication()
    main = MainWindow()
    main.show()
    app.exec_()

方案2：用事件过滤替代grabKeyboard() #

如果你的需求是捕获整个应用内的键盘输入，可以给QApplication安装全局事件过滤器实现相同效果，不会触发窗口拖动异常：

#!/usr/bin/env python3
from PySide2.QtCore import QObject, QEvent
from PySide2.QtWidgets import QApplication, QMainWindow, QAction, QLineEdit

class GlobalKeyFilter(QObject):
    def eventFilter(self, obj, event):
        if event.type() == QEvent.KeyPress:
            # 此处写你的键盘处理逻辑，和grabKeyboard捕获效果一致
            print(f"捕获按键：{event.key()}")
            # 需要转发给输入控件就返回False，需要拦截输入就返回True
        return super().eventFilter(obj, event)

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        menu = self.menuBar()
        start_menu = menu.addMenu("Start")
        action = QAction("Test", self)
        action.triggered.connect(self.test)
        start_menu.addAction(action)
        line_edit = QLineEdit()
        self.setCentralWidget(line_edit)

    def test(self):
        print("clicked")

if __name__ == "__main__":
    app = QApplication()
    # 安装全局事件过滤器
    key_filter = GlobalKeyFilter()
    app.installEventFilter(key_filter)
    main = MainWindow()
    main.show()
    app.exec_()

方案3：升级框架版本 #

该bug在Qt 5.15.3及更高版本、Qt6全系列中已经完成修复，你可以将Raspbian环境的PySide2升级到最新版本，或者切换到PySide6，即可直接解决问题。

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