首次在VSCode搭建JavaFX项目遇启动错误求助

核心原因 #

--module-path是Java 9及以上版本才支持的模块化参数，出现该错误的核心原因是当前使用的JDK版本低于Java 9，或者VSCode配置的Java环境指向了低版本JDK。

具体解决步骤 #

• 第一步：检查本地JDK版本
  打开终端执行命令：

  java -version
  

  如果输出版本为1.8.x（即Java 8），立刻升级到Java 9+的LTS版本（推荐Java 11/17）。

• 第二步：配置VSCode的Java运行环境

  1. 按Ctrl+Shift+P打开命令面板，输入Java: Configure Java Runtime，在弹出界面中选择版本≥9的JDK作为项目默认运行环境。
  2. 若存在多个JDK，可在项目的.vscode/settings.json中手动指定JDK路径：

     {
         "java.home": "C:\\Program Files\\Java\\jdk-17.0.8" // 替换为你的JDK实际路径
     }
     

• 第三步：修正launch.json的VM参数配置
  确保vmArgs参数格式正确，路径和模块名无错误，示例配置如下：

  "vmArgs": "--module-path \"C:\\javafx-sdk-17.0.8\\lib\" --add-modules javafx.controls,javafx.fxml"
  

  注意：

  • 替换C:\\javafx-sdk-17.0.8\\lib为你实际下载的JavaFX SDK的lib文件夹路径
  • 若项目用到FXML、media等模块，需在--add-modules后补充对应的模块名，用逗号分隔

• 第四步：清理无效环境变量
  之前设置的_JAVA_OPTION环境变量可能与高版本JDK冲突，暂时删除该环境变量，重启VSCode和终端后再尝试运行项目。

内容的提问来源于stack exchange，提问作者Ferruccio Islam Bisceglia