JavaFX Scene Builder方向键OnKeyPressed仅Shift按下时生效问题求助

问题场景 #

你在校园项目的JavaFX开发中，给AnchorPane绑定了OnKeyPressed和OnKeyReleased事件，用来检测左右方向键的按下状态。目前OnKeyReleased功能正常，但OnKeyPressed只有按住Shift键时才会触发，设备是MacBook。

你的核心代码片段如下：

控制器关键代码 #

@FXML private void Input(KeyEvent e) {
    if(e.getCode().equals(KeyCode.LEFT)) {
        System.out.println("Pressed left");
    }
    System.out.println("KeyCode: " + e.getCode());
}

FXML关键代码 #

<AnchorPane maxHeight="-Infinity" maxWidth="-Infinity" minHeight="-Infinity" minWidth="-Infinity" 
            onKeyPressed="#moveLeft" onKeyReleased="#moveLeft" prefHeight="400.0" prefWidth="600.0" 
            xmlns="http://javafx.com/javafx/11.0.1" xmlns:fx="http://javafx.com/fxml/1" 
            fx:controller="seasweeper.seasweeper.PacificController">
    <!-- 子控件省略 -->
</AnchorPane>

问题成因 #

这个问题是MacOS系统全局快捷键和JavaFX焦点机制共同导致的：

1. 系统快捷键拦截：MacOS默认把左/右方向键绑定到了Mission Control的「切换到左侧/右侧空间」功能上。当你直接按下方向键时，系统会优先捕获这个事件执行窗口/空间切换，不会把事件传递给JavaFX应用；而按住Shift键时，系统的这个快捷键会被屏蔽，事件才会正常传递到你的应用中。
2. 节点焦点问题：AnchorPane默认不具备焦点遍历能力（focusTraversable默认为false），如果界面上有Button等可聚焦控件，焦点会默认落在这些控件上，导致AnchorPane接收不到键盘事件——这也会加剧事件无法触发的情况。

修复与规避方案 #

方案1：调整MacOS系统快捷键设置（最彻底） #

直接修改系统快捷键，避免和应用冲突：

• 打开「系统设置」→「桌面与程序坞」→「Mission Control」
• 找到「移动到左侧空间」和「移动到右侧空间」的快捷键选项，把它们改成带修饰键的组合（比如Ctrl+左方向键），或者直接点击快捷键区域清除绑定，这样方向键就会优先响应你的JavaFX应用。

方案2：确保目标节点获得焦点 #

让AnchorPane能够获取并保持焦点，这样它才能接收键盘事件：

1. 首先在FXML中给AnchorPane添加fx:id：

   <AnchorPane fx:id="mainAnchorPane" ... >
       <!-- 子控件省略 -->
   </AnchorPane>
   

2. 在控制器的initialize方法中设置焦点属性并请求焦点：

   @FXML private AnchorPane mainAnchorPane;
   
   @Override
   public void initialize(URL url, ResourceBundle rb) {
       // 允许AnchorPane获取焦点
       mainAnchorPane.setFocusTraversable(true);
       // 初始化时请求焦点
       mainAnchorPane.requestFocus();
   }
   

3. 另外，在切换场景的方法中，也要确保新场景的根节点获得焦点（比如在switchToPacific中）：

   @FXML private void switchToPacific() throws IOException {
       Parent root = FXMLLoader.load(getClass().getResource("pacific.fxml"));
       Scene scene = new Scene(root);
       // 获取当前Stage并设置场景
       Stage stage = (Stage) Button_Pacific.getScene().getWindow();
       stage.setScene(scene);
       // 请求根节点焦点
       root.requestFocus();
   }
   

方案3：全局事件监听（备选） #

如果不想修改系统设置，可以给整个Stage添加事件过滤器，这样不管焦点在哪个控件上，都能捕获键盘事件：

// 在应用启动或者控制器初始化时获取Stage
Stage stage = (Stage) mainAnchorPane.getScene().getWindow();
stage.addEventFilter(KeyEvent.KEY_PRESSED, event -> {
    if (event.getCode() == KeyCode.LEFT) {
        System.out.println("Pressed left");
        // 如果不想让事件继续传递，可以调用event.consume();
    }
});

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