VSCode运行Java项目：Maven与Gradle的构建与执行-VSCode-PHP中文网

vscode运行java项目需先确认构建工具并确保正确识别：maven项目须等pom.xml解析完成、依赖下载完毕，gradle项目需gradlew可执行且网络通畅；classpath路径错误、lombok未启用注解处理器、spring boot配置未传入等均会导致“无主类”或启动失败。

vscode运行java项目：maven与gradle的构建与执行

VSCode 里跑 Java 项目，mvn 和 gradlew 都能用，但触发方式、依赖加载时机、错误表现完全不同——别直接点“运行”按钮，先确认你用的是哪个构建工具，再看它是否真被 VSCode 识别了。

Maven 项目在 VSCode 中不是一打开就 ready 的。插件得先读取 pom.xml、下载依赖、生成 classpath，这个过程可能卡在后台，而 UI 没提示。

右下角弹出 “Import Maven project?” 时，必须点 Yes；如果误点了 “Don’t show again”，后续就得手动触发：右键 pom.xml → “Reload project”
侧边栏没出现 Maven Projects 视图，说明插件没激活——检查是否装了 Maven for Java 扩展（不是只装了 Extension Pack for Java）
mvn compile 在终端能跑，但 VSCode 里点 compile 报错 Could not resolve dependencies：大概率是镜像源没配，或 settings.xml 路径没设对（通过 java.configuration.maven.userSettings 指定）
多模块项目中，父 pom.xml 里漏了 <packaging>pom</packaging>，VSCode 会把它当普通模块处理，子模块不自动注册

Gradle 的导入本质是执行一次 gradlew --dry-run 来解析任务树，这步失败，整个任务面板就为空——和 Maven 不同，它不靠文件存在就启动，而靠命令可执行。

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

确保项目根目录有 gradlew（macOS/Linux）或 gradlew.bat（Windows），且有执行权限（chmod +x gradlew）
gradle/wrapper/gradle-wrapper.properties 里的 distributionUrl 如果指向私有仓库或不可达地址，会卡住；临时改成 https://services.gradle.org/distributions/gradle-8.10-bin.zip 测试
报错 Could not install Gradle distribution：不是插件问题，是网络或本地 ~/.gradle/wrapper/dists 权限异常，删掉该目录重试
用 Kotlin DSL（build.gradle.kts）但没装 Kotlin Language Server 插件，会导致语法解析失败，进而阻塞任务加载

VSCode 的 Java 运行/调试依赖语言服务器生成的 classpath，而这个 classpath 由构建工具输出决定——Maven 写进 target/classes，Gradle 写进 build/classes/java/main，路径不对就找不到 main 方法。

Maven 项目里，确认 src/main/java 是 Source Folder（右键 → “Add to Source Path”），否则编译输出不会进 classpath
Gradle 项目中，若自定义了 sourceSets（比如把代码放在 src/core/java），必须在 build.gradle 显式配置 java.srcDirs = ["src/core/java"]，否则 VSCode 看不到
修改过 outputDir 或用了 shadowJar 等插件，导致 class 文件不在默认路径，VSCode 就无法索引——此时只能手动在 .vscode/launch.json 中指定 classPaths
项目用了 Lombok，但没在 VSCode 设置里开启 annotation processor（java.configuration.updateBuildConfiguration 设为 interactive），会导致编译后无 main 方法字节码

这类插件目标不是简单编译，而是启动一个完整 JVM 进程，VSCode 默认不继承系统环境变量或用户配置，容易因参数缺失失败。

spring-boot:run 报 Port already in use：VSCode 启动的进程默认不读 application.properties，需在 launch.json 中加 "env": {"SERVER_PORT": "8081"}，或改用 mvn spring-boot:run -Dserver.port=8081 命令行方式
bootRun 找不到 application.yml：Gradle 默认只把 src/main/resources 加入 classpath，如果配置文件放在 src/config，得在 sourceSets.main.resources.srcDirs 里追加路径
执行时报 ClassNotFoundException，但 jar 包明明在 dependencies 里：检查是否用了 runtimeOnly 或 testImplementation，这些 scope 不参与编译期 classpath 构建
想让 VSCode 终端复用当前 shell 的 JAVA_HOME？设 java.terminal.useJavaHome 为 true，否则它可能用内置 JDK 而非你配的版本