VSCode运行Java失败主因是java.home未指向JDK根目录（含lib/modules）、JAVA_HOME与构建工具路径不一致，或launch.json中mainClass非全限定名；需验证路径有效性、启用自动构建配置并刷新项目。
VSCode 跑不起来 Java 项目，八成不是插件没装对，而是 JAVA_HOME、java.home、构建工具路径这三者没对齐——尤其当你在 macOS 或 Windows 上混用 Homebrew、SDKMAN、Oracle JDK 和 Temurin 时，错一个路径，整个链就断了。
java.home 配置必须指向 JDK 根目录，不是 jre，也不是 bin
VSCode 的 Java 扩展（比如 redhat.java）启动语言服务器时，会严格校验 java.home 指向的路径下是否存在 lib/rt.jar（Java 8）或 lib/modules（Java 9+）。如果指向了 JRE、或只到 bin 目录、或路径里有空格未转义，就会报 “Cannot resolve JDK” 或直接静默失败。
-
java.home值示例（macOS）："java.home": "/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home" -
java.home值示例（Windows）："java.home": "C:\Program Files\Eclipse Adoptium\jdk-17.0.9+9"（注意双反斜杠） - 验证方式：在 VSCode 终端中运行
$JAVA_HOME/bin/java -version，必须能输出版本号 - 常见坑：用
which java得到的路径是软链接或 shell wrapper，不能直接填进java.home
launch.json 中 mainClass 必须是全限定类名，且 class 文件已编译
VSCode 调试器不读 .java 源文件，它依赖编译后的 .class 文件和类路径。如果你改了包结构但没更新 mainClass，或者源码还没被 Maven/Gradle 编译过，调试按钮会灰掉，或报 ClassNotFoundException。
- 正确写法：
"mainClass": "com.example.Main"（不是src/main/java/com/example/Main.java） - Maven 项目必须确保
target/classes/下存在对应路径的.class文件；否则先执行mvn compile - 纯 Java 项目（无构建工具）需手动保证
javac已生成 class，且launch.json中"projectName"字段可留空或删掉 - 如果用
java -cp . com.example.Main能跑通，那launch.json就大概率没问题
Maven 项目依赖标红？别急着重装插件，先看 .vscode/settings.json
VSCode 的 Java 扩展默认不会自动把 pom.xml 里的依赖加进类路径，除非你明确开启构建配置同步。很多“依赖找不到”其实是语言服务器缓存没刷新，或构建模式被设成了 manual。
立即学习“Java免费学习笔记（深入）”；
- 在工作区
.vscode/settings.json中加这两行："java.configuration.updateBuildConfiguration": "automatic",<br>"java.compile.nullAnalysis.mode": "automatic"
- 右键
pom.xml→ “Reload project”，等右下角提示 “Java language server restarted” - 若仍标红，检查
mvn dependency:resolve是否成功；失败说明本地仓库损坏或镜像配置错误 - Gradle 项目同理，但要确认
build.gradle里sourceSets正确声明了java源目录
调试时断点不命中？检查 JVM 启动参数和源码映射
断点灰色、悬停显示 “No executable code found” —— 大概率是 class 文件没带调试信息，或源码路径与编译路径不匹配。VSCode 默认用 -g 编译，但 Maven/Gradle 可能覆盖了这个行为。
- Maven 用户检查
pom.xml是否有<debug>true</debug>（在maven-compiler-plugin配置里） - Gradle 用户确认
compileJava.options.debug = true - 在
launch.json的configurations里加"vmArgs": "-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=*:8000"不解决根本问题，反而可能冲突 - 最简验证：删掉
.vscode文件夹，重启 VSCode，让扩展重新生成配置
真正卡住人的从来不是“怎么配”，而是不知道哪一层出了问题：是系统环境变量没生效，还是 VSCode 读的是用户 settings 而非工作区 settings，抑或 Maven 插件用了不同 JDK 版本编译却让 VSCode 用另一个 JDK 调试。建议每次改完配置后，都打开命令面板（Cmd+Shift+P），运行 Java: Show Java Home 和 Java: List All Runtimes 看实际加载了什么。
