IntelliJ+Maven环境下JFoenix元素运行不显示问题求助

云上老周

2026-7-30

解决方案

1. 修正`module-info.java`的依赖声明

你的项目是模块化项目（存在module-info.java），必须显式声明对JFoenix模块的依赖，否则JVM无法加载JFoenix的组件类。

打开module-info.java，添加如下代码：

module 你的模块名 {
    // 保留你已有的requires声明
    requires com.jfoenix;
    // 若FXML控制器所在包需要被JFoenix访问，添加opens声明
    opens 你的控制器所在包 to javafx.fxml, com.jfoenix;
}

注：替换你的模块名为项目实际模块名称，你的控制器所在包为FXML控制器对应的包路径（比如com.example.myapp.controller）。

2. 验证FXML的命名空间配置

确保FXML文件根元素正确引入JFoenix相关配置，否则FXML加载器无法识别JFoenix组件。示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<?import com.jfoenix.controls.JFXButton?>
<?import javafx.scene.layout.VBox?>

<VBox xmlns="http://javafx.com/javafx/18"
      xmlns:fx="http://javafx.com/fxml/1"
      fx:controller="com.example.myapp.controller.MainController">
    <!-- JavaFX原生元素 -->
    <Button text="原生按钮"/>
    <!-- JFoenix元素 -->
    <JFXButton text="JFoenix按钮"/>
</VBox>

也可以使用前缀式命名空间：

<VBox xmlns="http://javafx.com/javafx/18"
      xmlns:fx="http://javafx.com/fxml/1"
      xmlns:jfx="http://javafx.com/jfoenix"
      fx:controller="com.example.myapp.controller.MainController">
    <jfx:JFXButton text="JFoenix按钮"/>
</VBox>