VSCode中Maven编译JavaFX项目报错：无法找到同包App类

问题场景 #

我有一个JavaFX项目，源码中h4131.app包下包含Main.java和App.java两个类：

Main.java #

package h4131.app;

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

App.java #

package h4131.app;

import javafx.application.Application;
import javafx.stage.Stage;

import java.io.IOException;

import h4131.view.WindowBuilder;

/**
 * JavaFX App
 */
public class App extends Application {

    @Override
    public void start(Stage stage) throws IOException {
        // WindowBuilder windowBuilder = new WindowBuilder(stage);
    }

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

}

预期编译Main.java时调用App类的main方法生成agile.jar可执行文件，但编译时出现以下错误：

Main.java:5: error: cannot find symbol
App.main(args);
^
symbol:   variable App
location: class Main
1 error
error: compilation failed

诡异的是，在VSCode外部通过shell执行java -jar agile.jar可以正常运行该jar包，因此推测问题出在VSCode的配置或编译环境上。我已经尝试过卸载重装JDK、调整环境变量路径、重启电脑、在VSCode中重建项目，但均未解决问题。

可能的解决方法 #

• 检查VSCode的Java项目路径配置
  打开.vscode/settings.json，确认Java运行时和源码路径配置正确：

  {
      "java.configuration.runtimes": [
          {
              "name": "JavaSE-17", // 替换为你使用的JDK版本
              "path": "你的JDK安装路径",
              "default": true
          }
      ],
      "java.project.sourcePaths": ["src"] // 确保指向你的源码根目录
  }
  

  如果是Eclipse风格项目，检查.classpath文件是否包含源码目录和正确的JDK引用。

• 清理Java语言服务器缓存
  打开VSCode命令面板（快捷键Ctrl+Shift+P），输入Java: Clean Java Language Server Workspace并执行，完成后重启VSCode，让语言服务器重新扫描加载项目文件。

• 确保终端编译时的工作目录正确
  如果是在VSCode终端手动执行编译命令，当前工作目录必须是项目根目录（即包含h4131文件夹的上层目录），正确的编译命令示例：

  javac -d bin h4131/app/*.java
  

  避免在h4131/app目录下直接编译单个文件，这样会导致类路径错误。

• 正确配置JavaFX SDK依赖
  由于是JavaFX项目，需确保VSCode能识别JavaFX SDK。可以在settings.json中添加依赖引用：

  "java.project.referencedLibraries": [
      "你的JavaFX SDK路径/lib/*.jar"
  ]
  

  更推荐使用Maven或Gradle管理项目依赖，这样插件会自动处理JavaFX的依赖配置，减少手动配置出错的概率。

• 验证项目目录结构
  确保源码目录结构与包名严格对应：比如源码根目录为src，则文件路径应为src/h4131/app/Main.java和src/h4131/app/App.java，VSCode需要正确识别这个src目录作为源码根。

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