VSCode中JavaFX结合Scene Builder运行报错：缺少JavaFX运行时组件

核心问题分析 #

你遇到的Error: JavaFX runtime components are missing错误，本质是运行App.java时未指定JavaFX的模块路径和所需模块。纯JavaFX的HelloWorld能正常运行，是因为你在launch.json里给HelloWorld的配置项添加了必要的VM参数，但App的配置项遗漏了这部分。另外，"Run Code"（Code Runner插件）默认不会加载JavaFX依赖，所以所有JavaFX程序用它运行都会报找不到包的错误。

解决步骤 #

1. 修复Run Java运行App.java的问题 #

打开.vscode/launch.json，找到名为"App"的配置项，添加vmArgs参数，内容与HelloWorld配置保持一致：

{
    "type": "java",
    "name": "App",
    "request": "launch",
    "mainClass": "App",
    "projectName": "Java VSCode test_a97e49e3",
    "vmArgs": "--module-path C:/openjfx-19.0.2.1_windows-x64_bin-sdk/javafx-sdk-19.0.2.1/lib --add-modules javafx.controls,javafx.fxml"
}

保存后，再用"Run Java"运行App.java即可正常启动程序。

2. 配置Run Code支持JavaFX程序（可选） #

如果想让"Run Code"也能运行JavaFX程序，需要修改VSCode的设置：

1. 打开设置界面（快捷键Ctrl+,），搜索code-runner.executorMap
2. 点击"编辑 in settings.json"，找到java对应的命令，替换为包含JavaFX参数的命令：

"code-runner.executorMap": {
    "java": "cd $dir && javac --module-path C:/openjfx-19.0.2.1_windows-x64_bin-sdk/javafx-sdk-19.0.2.1/lib --add-modules javafx.controls,javafx.fxml $fileName && java --module-path C:/openjfx-19.0.2.1_windows-x64_bin-sdk/javafx-sdk-19.0.2.1/lib --add-modules javafx.controls,javafx.fxml $fileNameWithoutExt"
}

注意：替换路径为你自己的JavaFX SDK的lib目录路径。

额外注意事项 #

• 确保FXML文件路径正确：你用getClass().getResource("MainScene.fxml")，需要保证MainScene.fxml和App.java在同一目录下，或者编译后class文件能找到该FXML文件。如果后续出现FXML加载失败，可尝试调整资源路径。
• 项目运行时版本建议与JavaFX版本匹配（比如Java 19搭配JavaFX 19），避免版本兼容问题。

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