NetBeans8.2中添加JFoenix至FXML后编译程序无法启动

这个问题的核心原因是JFoenix旧版本依赖JavaFX的私有内部API，而Java 9及以后的版本通过模块化系统隐藏了这些API，导致打包后的程序运行时无法找到com.sun.javafx.css.StyleConverterImpl类——但NetBeans IDE在运行时自动添加了允许访问这些内部API的参数，所以IDE内可以正常启动。

下面是具体的解决步骤：

1. 升级JFoenix到兼容Java 9+的版本 #

早期的JFoenix版本（比如8.x系列）是为Java 8设计的，依赖JavaFX的私有API。你需要更换为适配Java 9及以上的JFoenix版本（推荐9.0.10或更高），这些版本已经移除了对私有API的依赖，改用公开API实现样式逻辑。

2. 配置VM启动参数（如果暂时无法升级JFoenix） #

如果必须使用旧版JFoenix，需要在程序启动时添加允许访问私有API的VM参数：

--add-exports javafx.graphics/com.sun.javafx.css=ALL-UNNAMED

在NetBeans中配置的方法：

• 右键项目 -> 属性 -> 运行 -> VM选项，添加上述参数
• 同时要确保打包后的启动脚本（比如生成的.bat或.sh文件）中也包含这个参数，这样双击运行时才会生效

3. 确认依赖打包完整 #

虽然你提到LIB已添加到/dist文件夹，但还是要检查：

• JFoenix的jar文件确实存在于dist/lib目录下
• 启动脚本中的classpath是否正确包含了lib目录下的所有jar包（NetBeans默认会处理，但偶尔可能出现配置问题）

4. 检查Java版本一致性 #

确保IDE运行时使用的Java版本和你打包后运行程序的Java版本一致。如果IDE用的是Java 8，而打包后用Java 9+运行，也会出现这个私有API无法访问的问题——尽量统一使用Java 8或升级到Java 11+（搭配OpenJFX）。

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