如何修改通过FXML文件加载的JavaFX场景？

问题原因 #

你报错的核心原因是：scene.getRoot()返回的是通用的Node类型，而Node本身并没有getChildren()方法——只有Parent类（以及它的子类，比如BorderPane、Pane等容器类）才实现了这个方法，所以必须将根节点强制转换为BorderPane才能调用相关方法。

关于getChildren()的返回值 #

对于BorderPane这类Parent子类，getChildren()返回的是ObservableList<Node>，这是一个可修改的节点列表。但要注意：BorderPane的children列表中存储的是它的五个区域（top、bottom、left、right、center）对应的节点，直接调用add()方法添加节点会破坏BorderPane的布局逻辑，导致节点无法正确显示在预期区域。

正确添加Canvas到BorderPane Center区域的方式 #

推荐使用BorderPane提供的专属方法setCenter(Node node)来设置中心区域的内容，这是官方设计的标准用法，能保证布局逻辑正常运行。

方式1：在start方法中强转根节点

@Override
public void start(Stage primaryStage) throws IOException {
    // 加载FXML文件
    FXMLLoader loader = new FXMLLoader(getClass().getResource("test.fxml"));
    Parent root = loader.load();
    Scene scene = new Scene(root);

    // 安全强转为BorderPane（用instanceof避免类型转换异常）
    if (root instanceof BorderPane mainBorderPane) {
        // 创建并初始化Canvas
        Canvas canvas = new Canvas(600, 400);
        GraphicsContext gc = canvas.getGraphicsContext2D();
        // 示例绘制：画一个绿色矩形
        gc.setFill(Color.GREEN);
        gc.fillRect(100, 100, 200, 150);

        // 将Canvas设置到BorderPane的Center区域
        mainBorderPane.setCenter(canvas);
    }

    primaryStage.setScene(scene);
    primaryStage.setTitle("Canvas in BorderPane");
    primaryStage.show();
}

方式2：通过FXML的fx:id注入（更规范）

这种方式符合JavaFX的MVC设计模式，代码结构更清晰：

1. 在FXML文件中给BorderPane添加fx:id：

<BorderPane fx:id="mainBorderPane" xmlns="http://javafx.com/javafx"
            xmlns:fx="http://javafx.com/fxml" fx:controller="com.example.YourController">
    <top>
        <TabPane>
            <Tab text="标签页1"/>
            <Tab text="标签页2"/>
        </TabPane>
    </top>
</BorderPane>

2. 在控制器类中通过@FXML注解注入BorderPane，然后在initialize()方法中添加Canvas：

import javafx.fxml.FXML;
import javafx.scene.canvas.Canvas;
import javafx.scene.canvas.GraphicsContext;
import javafx.scene.layout.BorderPane;
import javafx.scene.paint.Color;

public class YourController {
    @FXML
    private BorderPane mainBorderPane;

    public void initialize() {
        // 创建Canvas并绘制内容
        Canvas canvas = new Canvas(600, 400);
        GraphicsContext gc = canvas.getGraphicsContext2D();
        gc.setFill(Color.ORANGE);
        gc.fillOval(150, 120, 180, 180);

        // 设置到Center区域
        mainBorderPane.setCenter(canvas);
    }
}

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