如何将Java SDK从ModulePath移至Classpath？解决JavaFX模块缺失问题

一、将Java SDK从ModulePath移至Classpath的步骤 #

• 右键你的JavaFX项目，选择Build Path → Configure Build Path
• 在弹出窗口的Libraries标签页，找到ModulePath下的Java SDK条目（比如JRE System Library [javaSE-17]），选中后点击右侧的Remove
• 点击Add Library，选择JRE System Library，点击Next
• 选择你正在使用的Java SE 17版本，点击Next
• 在这一步的Library location下方，勾选Add to classpath（默认可能是Add to modulepath，需手动切换），然后点击Finish
• 回到Libraries标签页，确认Java SDK已出现在Classpath下，点击Apply and Close

二、解决“Module javafx.controls not found”的额外排查点 #

1. 检查模块声明（如果是模块化项目） #

如果项目根目录存在module-info.java文件，确保里面添加了JavaFX控件模块的依赖：

module your.project.name {
    requires javafx.controls;
    // 若用到FXML，需追加requires javafx.fxml;
}

如果是非模块化项目，直接删除module-info.java即可，非模块化模式不需要该文件。

2. 验证VM运行参数 #

确认Run Configurations中的VM参数设置无误：

• 右键项目 → Run As → Run Configurations
• 选中你的JavaFX启动类，切换到Arguments标签页
• 在VM arguments中确保包含以下内容（替换为你的JavaFX SDK实际lib路径）：

--module-path "你的JavaFX SDK/lib目录路径" --add-modules javafx.controls,javafx.fxml

注意路径含空格时必须加引号，且路径要和本地JavaFX的lib目录完全匹配。

3. 确认JavaFX依赖添加方式 #

若使用Maven/Gradle管理依赖（而非手动添加SDK），需确保配置正确：

• Maven：在pom.xml中添加JavaFX依赖及插件，明确指定所需模块
• Gradle：在build.gradle中配置JavaFX插件，并声明需要引入的模块

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