Linux Mint环境VSCode配置JavaFX失败，模块化运行存冗余报错

我在Linux Mint 21系统中已安装JDK 17，按JavaFX官方的VSCode配置指南操作后，始终无法正常运行HelloFX项目。

项目结构 #

项目根目录为HelloFX，结构如下：

HelloFX/
├── bin/
├── lib/
└── src/
    └── hellofx/
        ├── App.java
        ├── Controller.java
        └── hellofx.fxml

代码文件 #

App.java #

package hellofx;

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;

public class App extends Application {

    @Override
    public void start(Stage primaryStage) throws Exception{
        Parent root = FXMLLoader.load(getClass().getResource("hellofx.fxml"));
        primaryStage.setTitle("Hello World");
        primaryStage.setScene(new Scene(root, 400, 300));
        primaryStage.show();
    }

    public static void main(String[] args) {
        launch(App.class);
    }
}

Controller.java #

package hellofx;
import javafx.scene.control.Label;

public class Controller {
    private Label label;

    public void initialize() {
        String javaVersion = System.getProperty("java.version");
        String javafxVersion = System.getProperty("javafx.version");
        label.setText("Hello, JavaFX " + javafxVersion + "\nRunning on Java " + javaVersion + ".");
    }
}

注：原代码缺失包声明和Label类导入，这会导致运行错误，已补充。

hellofx.fxml #

<?xml version="1.0" encoding="UTF-8"?>

<?import javafx.scene.control.Label?>
<?import javafx.scene.layout.StackPane?>


<StackPane maxHeight="-Infinity" maxWidth="-Infinity" minHeight="-Infinity" minWidth="-Infinity" prefHeight="400.0" prefWidth="600.0" xmlns="http://javafx.com/javafx/8" xmlns:fx="http://javafx.com/fxml/1" fx:controller="hellofx.Controller">
    <children>
        <Label fx:id="label" text="Label" />
    </children>
</StackPane>

注：原FXML中xmlns属性的URL有多余空格，已修正为http://javafx.com/javafx/8。

已做的配置 #

1. launch.json配置

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "Launch App",
            "request": "launch",
            "mainClass": "hellofx.App",
            "vmArgs": "--module-path ~/Scaricati/javafx-sdk-21/lib --add-modules javafx.controls,javafx.fxml"
        }
    ]
}

2. 环境变量配置
   在.bashrc中添加：

export JAVA_HOME=/usr/lib/jvm/java-17-oracle

运行错误信息 #

执行后出现编译错误，提示JavaFX包不存在：

App.java:3: error: package javafx.application does not exist
import javafx.application.Application;
^
App.java:4: error: package javafx.fxml does not exist
import javafx.fxml.FXMLLoader;
^
App.java:5: error: package javafx.scene does not exist
import javafx.scene.Parent;
^
App.java:6: error: package javafx.scene does not exist
import javafx.scene.Scene;
^
App.java:7: error: package javafx.stage does not exist
import javafx.stage.Stage;
^
App.java:9: error: cannot find symbol
public class App extends Application {
^
symbol: class Application
App.java:12: error: cannot find symbol
public void start(Stage primaryStage) throws Exception{
^
symbol: class Stage
location: class App
App.java:11: error: method does not override or implement a method from a supertype
@Override
^
App.java:13: error: cannot find symbol
Parent root = FXMLLoader.load(getClass().getResource("hellofx.fxml"));
^
symbol: class Parent
location: class App
App.java:13: error: cannot find symbol
Parent root = FXMLLoader.load(getClass().getResource("hellofx.fxml"));
^
symbol: variable FXMLLoader
location: class App
App.java:13: error: cannot find symbol
Parent root = FXMLLoader.load(getClass().getResource("hellofx.fxml"));
^
symbol: method getClass()
location: class App
App.java:15: error: cannot find symbol
primaryStage.setScene(new Scene(root, 400, 300));
^
symbol: class Scene
location: class App
App.java:20: error: cannot find symbol
launch(App.class);
^
symbol: method launch(Class<App>)
location: class App
13 errors

补充说明 #

使用模块化方法可以运行程序，但控制台会被大量错误信息填满，需要解决这个问题。

一、修复非模块化配置的编译错误 #

1. 修正JavaFX SDK路径 #

launch.json中的--module-path建议使用绝对路径，避免波浪号解析异常：
将~/Scaricati/javafx-sdk-21/lib替换为/home/你的用户名/Scaricati/javafx-sdk-21/lib，确保路径指向JavaFX SDK的lib目录。

2. 配置VSCode项目依赖 #

在项目根目录创建.classpath文件，明确添加JavaFX库引用：

<?xml version="1.0" encoding="UTF-8"?>
<classpath>
    <classpathentry kind="src" path="src"/>
    <classpathentry kind="output" path="bin"/>
    <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-17"/>
    <classpathentry kind="lib" path="/home/你的用户名/Scaricati/javafx-sdk-21/lib/javafx.base.jar"/>
    <classpathentry kind="lib" path="/home/你的用户名/Scaricati/javafx-sdk-21/lib/javafx.controls.jar"/>
    <classpathentry kind="lib" path="/home/你的用户名/Scaricati/javafx-sdk-21/lib/javafx.fxml.jar"/>
    <classpathentry kind="lib" path="/home/你的用户名/Scaricati/javafx-sdk-21/lib/javafx.graphics.jar"/>
</classpath>

3. 完善代码错误 #

确保Controller类添加包声明和Label导入，FXML文件的xmlns属性无空格，避免解析失败。

二、解决模块化运行的大量错误信息 #

1. 添加模块声明文件 #

在src目录下创建module-info.java：

module hellofx {
    requires javafx.controls;
    requires javafx.fxml;

    opens hellofx to javafx.fxml;
    exports hellofx;
}

opens hellofx to javafx.fxml是必须项，FXML需要反射访问Controller类。

2. 调整launch.json参数 #

模块化运行时，VM参数可简化为：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "Launch App",
            "request": "launch",
            "mainClass": "hellofx.App",
            "vmArgs": "--module-path /home/你的用户名/Scaricati/javafx-sdk-21/lib --module hellofx/hellofx.App"
        }
    ]
}

3. 过滤控制台日志 #

如果仍有大量冗余日志，可调整VSCode设置：

• 打开设置，搜索java.logging.level，将值改为warning或error，减少非必要日志输出。
• 暂时禁用无关插件，排查是否存在插件干扰。

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