PySide6键盘输入响应问题：按数字键更新标签显示

常见原因及修复方法 #

1. 确保窗口/控件获得焦点 #

键盘事件只会发送给拥有焦点的控件。如果你的keyPressEvent写在主窗口类中，需要确保窗口处于激活状态，且没有其他控件（如输入框、按钮）抢占焦点。可以在窗口初始化时添加：

self.setFocusPolicy(QtCore.Qt.StrongFocus)

如果是自定义控件，也要给该控件设置相同的焦点策略。

2. 修正super调用的语法错误 #

你代码里的super(self).keyPressEvent(event)写法错误，正确的调用方式是：

super().keyPressEvent(event)

或明确指定类名：

super(YourWindowClassName, self).keyPressEvent(event)

错误的super调用会导致父类事件无法正常传递，虽然这不是事件未触发的核心原因，但必须修正。

3. 处理控件事件拦截问题 #

如果窗口内有QLineEdit、QPushButton这类自带键盘事件处理逻辑的控件，它们会拦截事件，不会传递给父窗口。此时可以给主窗口安装事件过滤器来统一捕获键盘事件：

def __init__(self):
    # 其他初始化代码
    self.installEventFilter(self)

def eventFilter(self, obj, event):
    if event.type() == QtCore.QEvent.KeyPress:
        key = event.key()
        print(f"Found key {key}")
        # 直接通过键值判断（Key_1到Key_5对应49-53）
        if 49 <= key <= 53:
            self.selected_bin = key - 48
            self.set_current_bin()
            return True  # 标记事件已处理，不再传递
    return super().eventFilter(obj, event)

4. 极简测试代码验证 #

先运行以下极简案例，确认事件能正常触发：

import sys
from PySide6 import QtCore, QtWidgets

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.label = QtWidgets.QLabel("Press 1-5", self)
        self.setCentralWidget(self.label)
        self.setFocusPolicy(QtCore.Qt.StrongFocus)

    def keyPressEvent(self, event):
        key = event.key()
        print(f"Key pressed: {key}")
        if key == QtCore.Qt.Key_1:
            self.label.setText("Current bin: 1")
        elif key == QtCore.Qt.Key_2:
            self.label.setText("Current bin: 2")
        elif key == QtCore.Qt.Key_3:
            self.label.setText("Current bin: 3")
        elif key == QtCore.Qt.Key_4:
            self.label.setText("Current bin: 4")
        elif key == QtCore.Qt.Key_5:
            self.label.setText("Current bin: 5")
        else:
            super().keyPressEvent(event)

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

运行后点击窗口确保它获得焦点，再按数字键，应该能看到标签内容更新和控制台的键值输出。

总结 #

优先排查焦点问题（最常见原因），其次修正super调用语法，若存在控件拦截事件则使用事件过滤器统一处理。

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