VSCode运行Java项目需先确认构建工具并确保正确识别：Maven项目须等pom.xml解析完成、依赖下载完毕，Gradle项目需gradlew可执行且网络通畅；classpath路径错误、Lombok未启用注解处理器、Spring Boot配置未传入等均会导致“无主类”或启动失败。
VSCode 里跑 Java 项目，mvn 和 gradlew 都能用，但触发方式、依赖加载时机、错误表现完全不同——别直接点“运行”按钮，先确认你用的是哪个构建工具，再看它是否真被 VSCode 识别了。
为什么点“Run”没反应？Maven 项目要等 pom.xml 解析完成
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 项目卡在 “Importing Gradle project…” 怎么办？
Gradle 的导入本质是执行一次 gradlew --dry-run 来解析任务树，这步失败，整个任务面板就为空——和 Maven 不同，它不靠文件存在就启动，而靠命令可执行。
- 确保项目根目录有
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插件，会导致语法解析失败，进而阻塞任务加载
运行主类时提示 “No main class found”？classpath 没生效
VSCode 的 Java 运行/调试依赖语言服务器生成的 classpath，而这个 classpath 由构建工具输出决定——Maven 写进 target/classes，Gradle 写进 build/classes/java/main，路径不对就找不到 main 方法。
立即学习“Java免费学习笔记（深入）”；
- 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方法字节码
执行 mvn spring-boot:run 或 gradle bootRun 失败？端口/配置没传进去
这类插件目标不是简单编译，而是启动一个完整 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 而非你配的版本
真正卡住的地方，往往不是构建脚本写错了，而是 VSCode 没拿到构建工具生成的元信息——它不执行 mvn 或 gradlew，只是监听它们的输出结果。所以任何一步中断（网络、权限、路径、scope），都会让后续功能静默失效。
