在桌面应用开发中，经常会遇到需要从主界面再打开一个功能完全相同、但数据各自独立的操作窗口的场景。JavaFX 提供了 FXML 来描述界面结构，如果希望复用同一份布局文件生成多个可交互窗口，就必须理解 FXMLLoader 的实例化机制以及 Controller 的生命周期。
为什么不能直接共用 Controller
不少人在第一次写多窗口时，会尝试把同一个 Controller 对象设置给多个 Stage 的界面，以为这样能少写代码。实际上 FXMLLoader 在加载时会将 fx:controller 指定的类实例化，并把界面上的 @FXML 字段注入到这个实例里。如果多个窗口共用一个 Controller，那么后加载的窗口会把前面窗口的按钮、文本框引用覆盖掉，导致你操作 A 窗口却改动了 B 窗口的组件。
另外，事件处理方法通常写在 Controller 里，共用实例意味着所有窗口的按钮点击都会调用同一组方法，而方法内部如果直接操作字段，就分不清当前用户到底在哪个窗口操作。这种数据串台问题在调试时非常隐蔽，往往要运行很久才暴露。因此，每个窗口都必须有自己独立的 Controller 实例。
标准克隆窗口的实现步骤
核心思路是：每次需要新窗口，都新建一个 FXMLLoader，指定同一个 FXML 资源路径，调用 load() 方法得到根节点，再通过 getController() 拿到本次加载产生的独立 Controller。最后把根节点放进新 Scene，挂到新 Stage 上显示。
下面的示例展示了一个工具方法，可以在任何地方调用它来克隆出新的独立窗口。注意 FXML 路径使用 ClassLoader 获取，避免硬编码绝对路径；Controller 中不需要写特殊代码，只要正常声明 @FXML 成员即可。
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;
import java.io.IOException;
public class WindowCloner {
// 复用同一份FXML，每次都创建新的Stage和Controller
public static void openCloneWindow(String fxmlPath, String title) throws IOException {
FXMLLoader loader = new FXMLLoader(WindowCloner.class.getResource(fxmlPath));
Parent root = loader.load();
Object controller = loader.getController();
Stage stage = new Stage();
stage.setTitle(title);
stage.setScene(new Scene(root, 400, 300));
stage.show();
}
}
假设我们有一个名为 sample.fxml 的布局，里面有一个文本框和一个按钮，对应的 SampleController 如下。每次调用 openCloneWindow 都会 new 出新的 SampleController，所以两个窗口输入的内容互不干扰。
import javafx.fxml.FXML;
import javafx.scene.control.TextField;
public class SampleController {
@FXML
private TextField inputField;
@FXML
public void onButtonClick() {
System.out.println("当前窗口输入：" + inputField.getText());
}
}
FXML 文件与加载注意点
在 FXML 中，通常通过 fx:controller 属性声明控制器类。由于每次 FXMLLoader.load() 都会重新读取并解析 XML，因此不需要在 Java 代码里手动 setController，否则反而会抛出初始化异常。FXML 里的组件 id 与 Controller 里的 @FXML 字段名必须一致，这是由 JavaFX 反射注入保证的。
如果 FXML 中引用了外部样式表或图片资源，建议使用相对路径并放在 resources 目录下，这样打包后也能正确加载。下面是一段简单的 FXML 示例，注意其中的 <TextField> 和 <Button> 标签都是普通布局描述，不是 HTML 标签。
<?xml version="1.0" encoding="UTF-8"?>
<?import javafx.scene.layout.VBox?>
<?import javafx.scene.control.TextField?>
<?import javafx.scene.control.Button?>
<VBox xmlns="http://javafx.com/javafx" fx:controller="SampleController">
<TextField fx:id="inputField" promptText="请输入内容"/>
<Button text="提交" onAction="#onButtonClick"/>
</VBox>
窗口独立性与模态设置
克隆出来的窗口默认是非模态的，用户可以先操作新窗口再切回旧窗口。如果你希望新窗口阻塞主窗口，可以调用 stage.initModality(Modality.WINDOW_MODAL) 并设置 owner。每个 Stage 的 Modality 互不影响，因此你可以混合使用模态与非模态克隆窗口。
另一个容易忽略的点是，当窗口关闭时，JavaFX 不会自动把 Controller 里的大对象置空。如果 Controller 持有数据库连接或监听了全局事件，应在界面关闭事件中移除监听或释放资源，否则多个克隆窗口累积会造成内存泄漏。
stage.setOnHidden(event -> {
// 假设controller提供了清理方法
if (controller instanceof Cleanable) {
((Cleanable) controller).cleanup();
}
});
常见误区与排查建议
有人会问：能不能把第一个窗口的 Scene 直接塞给第二个 Stage？答案是不能，因为一个 Parent 节点只能属于一个 Scene。强行复用会报 IllegalArgument 异常。此外，不要在 Controller 里写静态变量来保存界面状态，这会让所有克隆窗口共享数据，背离独立交互的初衷。
当发现克隆窗口行为异常时，先打印 loader.getController() 的对象地址，确认每次都不是同一个实例；再检查 FXML 里是否误用了 fx:controller 之外的手动绑定。只要保证加载流程干净、实例隔离，JavaFX 多窗口克隆就非常稳定可靠。