如何在PySide中指定与键盘布局无关的按键序列？

可以实现，核心是绑定物理按键而非字符映射。你当前的代码使用QKeySequence("Ctrl+,")是基于当前键盘布局的字符匹配，导致非美式布局下快捷键会偏离预期。改用Qt的逻辑键（或扫描码）绑定物理按键，就能解决这个问题。

修改后的代码 #

from PySide6.QtGui import QAction, QKeySequence
from PySide6.QtWidgets import QApplication, QMainWindow
from PySide6.QtCore import Qt


class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        menubar = self.menuBar()
        file_menu = menubar.addMenu("File")

        settings_action = QAction("Preferences", self)
        settings_action.setMenuRole(QAction.MenuRole.PreferencesRole)

        # 优先使用系统标准的偏好设置快捷键
        settings_key = QKeySequence(QKeySequence.StandardKey.Preferences)
        
        if not settings_key.toString():
            # 绑定物理按键：Ctrl + 美式布局中逗号所在的键
            # Qt.Key_Comma对应该物理按键，与当前键盘布局无关
            settings_key = QKeySequence(Qt.ControlModifier | Qt.Key_Comma)

        settings_action.setShortcut(settings_key)
        settings_action.triggered.connect(lambda: print("Opened"))

        file_menu.addAction(settings_action)


if __name__ == "__main__":
    app = QApplication()
    window = MainWindow()
    window.show()
    app.exec()

改动说明 #

• Qt.Key_Comma对应的是美式键盘中逗号所在的物理按键，而非字符","。无论当前切换到哪种键盘布局，按下该物理按键时，Qt都会识别为Qt.Key_Comma事件。
• 结合Qt.ControlModifier（Ctrl键），就能实现跨布局固定响应美式Ctrl+逗号的按键组合，完全符合你的需求。

进阶方案（针对特殊布局场景） #

如果遇到某些极端布局导致逻辑键映射异常，可以直接使用平台相关的扫描码绑定物理按键（扫描码是硬件级别的按键标识，完全固定）：

import sys
from PySide6.QtCore import Qt
from PySide6.QtGui import QKeySequence

# 根据平台指定美式逗号键的扫描码
if sys.platform == "win32":
    settings_key = QKeySequence(Qt.ControlModifier | Qt.ScanCode(0x36))
elif sys.platform == "linux":
    settings_key = QKeySequence(Qt.ControlModifier | Qt.ScanCode(0x2C))
elif sys.platform == "darwin":
    settings_key = QKeySequence(Qt.ControlModifier | Qt.ScanCode(0x2B))

这种方式需要处理不同操作系统的扫描码差异，仅在逻辑键方案不生效时使用。

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