IntelliJ IDEA 2023.1配置JavaFX VM选项失败,运行报错模块找不到
解决IntelliJ IDEA 2023.1非模块化JavaFX项目配置报错问题
核心错误修正
你之前把VM选项参数放到了程序参数栏,这是导致java: module not found: javafx.controls错误的直接原因——程序参数是传给main方法的参数,而JavaFX的模块路径和模块依赖需要JVM启动时加载,必须放在VM选项里。
2023.1版本IntelliJ正确配置步骤
- 确认项目是非模块化:确保项目根目录下没有
module-info.java文件,若有则删除(非模块化项目无需该文件)。 - 正确配置VM选项:
- 打开
Run > Edit Configurations,找到你的HelloApplication运行配置 - 在配置界面中,定位到VM options输入框(2023.1版本该选项在
Build and run标签下,也可直接搜索"VM options"快速找到) - 填入正确参数,替换成你实际的JavaFX SDK路径:
注意:Windows下若路径包含空格,必须用双引号包裹。--module-path "D:\javafx-sdk-20\lib" --add-modules javafx.controls,javafx.fxml
- 打开
- 验证库依赖:
- 打开
File > Project Structure > Libraries,检查JavaFX SDK的lib目录已添加为库,且当前模块的Dependencies列表中能看到javafx.controls、javafx.fxml等依赖项。
- 打开
- 重新运行:启动HelloApplication,此时JVM会正确加载JavaFX模块,报错问题即可解决。
额外排查点
- 确认JavaFX SDK版本与JDK版本兼容(JavaFX 20建议搭配JDK 17及以上版本)
- 检查VM选项中的路径是否拼写正确,不要遗漏
\lib后缀 - 确保运行配置关联的是当前项目模块
内容的提问来源于stack exchange,提问作者jachai.sotaro
相关产品推荐
相关产品推荐

