为何HBox在Pane容器中不可见？附JavaFX测试代码

咱们来拆解一下你遇到的这个问题——核心原因其实是你代码里的pane变量虽然声明为Pane，但实际实例化的是BorderPane，而BorderPane的布局规则和普通Pane完全不一样。

BorderPane是一个带区域划分的布局容器，它要求所有子节点必须被明确放到它的五个预设区域（top、bottom、left、right、center）中的某一个。你直接调用pane.getChildren().add(hBox)只是把HBox加到了节点列表里，但BorderPane不会给没有指定区域的节点分配任何布局空间，所以这个HBox虽然存在于场景图中，但根本不会被渲染出来。而当你把HBox直接作为Scene的根节点时，Scene会默认适配HBox的布局逻辑，自然就能正常显示绿色方块了。

两种修复方案 #

方案一：正确使用BorderPane的区域放置 #

把HBox放到BorderPane的某个区域（比如center），这样BorderPane就会为它分配空间：

package sample;
import javafx.application.Application;
import javafx.geometry.Insets;
import javafx.scene.Scene;
import javafx.scene.layout.*;
import javafx.scene.paint.Color;
import javafx.stage.Stage;

public class Main extends Application {
    @Override
    public void start(Stage primaryStage) {
        // 建议直接声明为BorderPane，避免类型混淆
        BorderPane pane = new BorderPane();
        pane.setBackground(new Background(new BackgroundFill(Color.RED, CornerRadii.EMPTY, Insets.EMPTY)));
        HBox hBox = new HBox();
        hBox.setBackground(new Background(new BackgroundFill(Color.GREEN, CornerRadii.EMPTY, Insets.EMPTY)));
        hBox.setPrefHeight(100);
        hBox.setPrefWidth(100);
        // 将HBox放置到BorderPane的中心区域
        pane.setCenter(hBox);
        primaryStage.setScene(new Scene(pane, 300, 275));
        primaryStage.show();
    }
    public static void main(String[] args) {
        launch(args);
    }
}

方案二：改用普通Pane #

如果你本来就不需要BorderPane的区域布局，直接用普通Pane即可——普通Pane会渲染所有子节点，不过它是绝对布局，你可能需要手动调整HBox的位置让它显示在合适的地方：

package sample;
import javafx.application.Application;
import javafx.geometry.Insets;
import javafx.scene.Scene;
import javafx.scene.layout.*;
import javafx.scene.paint.Color;
import javafx.stage.Stage;

public class Main extends Application {
    @Override
    public void start(Stage primaryStage) {
        Pane pane = new Pane();
        pane.setBackground(new Background(new BackgroundFill(Color.RED, CornerRadii.EMPTY, Insets.EMPTY)));
        HBox hBox = new HBox();
        hBox.setBackground(new Background(new BackgroundFill(Color.GREEN, CornerRadii.EMPTY, Insets.EMPTY)));
        hBox.setPrefHeight(100);
        hBox.setPrefWidth(100);
        // 手动设置HBox的位置，让它居中显示
        hBox.setLayoutX(100);
        hBox.setLayoutY(87);
        pane.getChildren().add(hBox);
        primaryStage.setScene(new Scene(pane, 300, 275));
        primaryStage.show();
    }
    public static void main(String[] args) {
        launch(args);
    }
}

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