使用Zulu JDK-FX 17时FXSampler App无法检测到ControlsFX示例

• 匹配ControlsFX与JDK版本兼容性
  确保引入的ControlsFX版本适配Zulu JDK-FX 17，推荐使用11.1.2及以上版本。pom.xml中明确指定版本：

  <dependency>
      <groupId>org.controlsfx</groupId>
      <artifactId>controlsfx</artifactId>
      <version>11.1.2</version>
  </dependency>
  

• 使用正确的启动类
  不要直接运行FXSampler类，改用org.controlsfx.fxsampler.FXSamplerLauncher启动，确保示例包能被正确扫描。

• 检查项目模块配置
  如果是模块化项目，在module-info.java中声明依赖：

  requires org.controlsfx.controls;
  

  非模块化项目则确认所有依赖都在类路径下正常加载。

• 清理重建项目
  在Eclipse中执行Project > Clean，重新构建项目，清除编译缓存或依赖加载异常。

• 验证示例类的注解标记
  检查org.controlsfx.samples下的示例类是否添加了@Sample注解，示例格式如下：

  @Sample
  public class SampleDemo extends VBox {
      // 示例实现代码
  }
  

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