JavaFX全屏模式下切换FXML场景的问题与实现方案

你碰到的切换时全屏短暂退出的问题，根源就是每次跳转都新建Scene、调用stage.setScene()替换整个场景。Stage在替换Scene对象时会重置窗口渲染状态，哪怕你紧接着调用setFullScreen(true)，中间也会有一个短暂的状态切换窗口，视觉上就是退出全屏再恢复的闪烁。而且反复创建销毁Scene本身也不是JavaFX推荐的界面切换写法。

JavaFX做界面切换的通用最佳实践根本不需要替换整个Scene——整个App生命周期只保留一个Scene实例就够了，切换界面时只替换Scene的根节点，Stage的全屏、尺寸、样式等属性全程不动，从根源上不会触发状态重置，自然就不会有闪烁。

注意：你现有的两个FXML文件不需要做任何修改，直接替换Java代码即可运行。

改造后主类代码 SwitchScenesExample.java #

public class SwitchScenesExample extends Application {
  // 全局持有唯一的Scene实例
  public static Scene mainScene;
  static double resWidth = Screen.getPrimary().getBounds().getWidth();
  static double resHeight = Screen.getPrimary().getBounds().getHeight();

  @Override
  public void start(Stage stage) throws IOException {
    // 首次加载初始界面
    FXMLLoader fxmlLoader = new FXMLLoader(SwitchScenesExample.class.getResource("scene2.fxml"));
    Parent root = fxmlLoader.load();
    // 整个应用生命周期只创建这一次Scene
    mainScene = new Scene(root, resWidth, resHeight);
    Controller controller = fxmlLoader.getController();
    controller.setNextScene("scene1.fxml");
    
    stage.setTitle("SwitchingFXML");
    stage.setScene(mainScene);
    stage.setFullScreen(true);
    stage.show();
  }

  public static void main(String[] args) {
    launch();
  }
}

改造后控制器代码 Controller.java #

import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.control.Button;
import javafx.scene.layout.GridPane;
import java.io.IOException;

public class Controller {
  private String nextScene;
  @FXML
  private Button sceneButton;
  @FXML
  private GridPane gridPane;

  public void setNextScene(String fileName) {
    this.nextScene = fileName;
  }
  @FXML
  void onSceneButtonClicked(ActionEvent event) {
    try {
      FXMLLoader loader = new FXMLLoader(getClass().getResource(nextScene));
      Parent newRoot = loader.load();
      // 切换下一个界面的跳转目标
      Controller controller = loader.getController();
      if(nextScene.equals("scene1.fxml")) {
        controller.setNextScene("scene2.fxml");
        nextScene = "scene2.fxml";
      } else {
        controller.setNextScene("scene1.fxml");
        nextScene = "scene1.fxml";
      }
      // 直接替换Scene根节点，不改动Stage状态，完全不会触发全屏闪烁
      SwitchScenesExample.mainScene.setRoot(newRoot);
    }catch (IOException io){
      io.printStackTrace();
    }
  }
}

• 高频切换的界面（比如主界面、侧边菜单、常用弹窗内容）可以提前加载FXML并缓存根节点，跳转时直接用缓存节点替换，省去每次IO读FXML、解析节点树的开销，切换更丝滑
• 界面传参可以沿用你现在的写法：加载完FXML拿到控制器实例，调用自定义的setter方法传入参数即可，不需要依赖全局变量
• 复杂项目建议单独封装导航管理器类，统一维护FXML路径、节点缓存、跳转规则、传参逻辑，避免每个控制器里重复写FXMLLoader加载代码，也方便统一加跳转过渡动画
• 非必要不要在控制器里直接操作Stage对象，窗口级别的属性（全屏、尺寸、置顶等）统一在主启动类里管理，避免分散修改导致的状态混乱

如果碰到极特殊场景必须替换整个Scene（比如不同场景需要完全独立的全局样式表、光标配置），可以在替换前临时关闭全屏退出提示、禁用系统窗口动画，但这类场景占比极低，普通业务开发用替换根节点的方案完全够用。

内容的提问来源于stack exchange，提问作者Ernest P W