JavaFX自定义控件无法在Scene中显示问题求助

以下是针对你遇到的自定义控件未显示问题的逐一排查方向：

1. 自定义控件FXML加载逻辑检查 #

• 确认PackTestCC类中加载自身FXML的路径是否正确：若FXML与类同包，需用getClass().getResource("PackTestCC.fxml")，路径错误会导致控件加载失败却无明显报错。
• 检查加载代码是否绑定了根节点与控制器：必须包含loader.setRoot(this)和loader.setController(this)，缺少任一都会导致控件内容无法渲染。示例代码：

FXMLLoader loader = new FXMLLoader(getClass().getResource("PackTestCC.fxml"));
loader.setRoot(this);
loader.setController(this);
loader.load();

2. 自定义控件FXML根节点配置 #

• 打开PackTestCC.fxml，确认根节点是否使用fx:root指定自定义控件类型，示例：

<fx:root type="你的包路径.PackTestCC" xmlns:fx="http://javafx.com/fxml">
    <!-- 控件内部元素 -->
</fx:root>

• 确保FXML内的子控件有明确布局约束，比如AnchorPane子控件需设置topAnchor/leftAnchor等属性，否则控件可能因尺寸为0而不可见。

3. 主FXML引用自定义控件的正确性 #

• 检查main-view2.fxml是否正确导入自定义控件包，示例：

<?import 你的包路径.PackTestCC?>

• 确认主FXML中自定义控件的标签写法正确，且放置在能分配空间的布局区域（比如BorderPane的center区域），避免因布局容器未分配空间导致控件不可见。

4. 控件尺寸与布局约束 #

• 检查PackTestCC类是否重写了computePrefWidth/computePrefHeight方法，或在FXML中设置了prefWidth/prefHeight属性，默认尺寸为0会导致控件不可见。
• 若主布局用HBox/VBox，需将自定义控件的Hgrow/Vgrow属性设为ALWAYS，确保控件能填充容器空间。

5. 控制器初始化与数据绑定 #

• 在PackTestController和PackTestCC的initialize方法中添加打印语句，确认方法是否正常执行，未捕获异常会导致初始化失败。
• 检查PackTestModel的数据是否正确传递并绑定到控件，空数据或错误绑定会导致控件内容空白。

6. 主程序加载逻辑验证 #

• 确认Main类中加载main-view2.fxml的代码无错误，添加异常捕获排查加载问题：

try {
    FXMLLoader loader = new FXMLLoader(getClass().getResource("main-view2.fxml"));
    Parent root = loader.load();
    primaryStage.setScene(new Scene(root));
    primaryStage.show();
} catch (IOException e) {
    e.printStackTrace();
}

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