Eclipse添加JavaFX到构建路径仍标记包缺失及启动报错求助

1. 编译期无法解析JavaFX引用类问题 #

• 确认JavaFX用户库属性：右键项目 → 构建路径 → 配置构建路径 → 找到已添加的JavaFX用户库 → 点击编辑 → 勾选「系统库（添加到引导类路径）」选项后保存，未勾选该选项会直接导致类无法识别。
• 校验版本兼容性：你使用的JavaFX版本需与本地JDK版本匹配，如JavaFX 21要求JDK 17及以上版本运行，版本不匹配会出现类引用失效问题。
• 清理项目缓存：点击顶部菜单栏「项目」→ 清理 → 选择对应项目执行清理，强制Eclipse重新编译所有类文件，清除旧缓存导致的错误提示。

2. 启动报错 Module JavaFXTest not found 问题 #

• 若项目保留module-info.java（模块化项目）：需在模块声明中正确声明依赖与导出规则，示例配置如下：

module JavaFXTest {
    requires javafx.controls;
    requires javafx.fxml;
    // 替换为你项目主类所在的包名
    exports com.yourproject.main;
    // 若使用FXML控制器，需开放对应包给javafx.fxml做反射调用
    opens com.yourproject.controller to javafx.fxml;
}

• 若项目未使用module-info.java（非模块化项目）：不要配置模块路径相关参数，直接将JavaFX用户库添加到项目类路径即可。
• 同步运行配置：右键启动类 → 运行方式 → 运行配置 → 找到对应Java应用启动项 → 切换到「依赖项」标签页，确认项目本身与JavaFX用户库已正确添加到模块路径（模块化项目）或类路径（非模块化项目），删除重建项目后旧运行配置未同步是该报错的常见诱因。

3. 已配置运行时参数仍提示找不到javafx.controls问题 #

• 校验--module-path路径正确性：路径必须指向JavaFX解压目录下lib文件夹的绝对路径，Windows系统下优先使用正斜杠，路径包含空格时必须用英文双引号包裹，正确示例：
  --module-path "C:/tools/javafx-sdk-21/lib" --add-modules javafx.controls,javafx.fxml
• 确认参数放置位置：上述参数必须添加到运行配置的「VM参数」输入框中，错误放到「程序参数」输入框会导致参数不生效。
• 非模块化项目不要混用模块路径参数：未使用module-info.java的项目无需配置--module-path相关参数，直接将JavaFX用户库添加到类路径即可正常加载。

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