必须确保java和javac版本一致且VS Code使用同一JDK；装全官方Java扩展；正确配置launch.json的mainClass和sourcePaths；刷新项目并重启Language Server。
装对 JDK 版本，别让 java -version 和 javac -version 对不上
VS Code 本身不带 Java 运行时，必须手动装好 JDK。常见问题是：系统 PATH 里配了 JDK 17，但 VS Code 启动时读到的是 JRE 8 或另一个旧版本的 java，导致 javac 编译成功、java 运行失败，或调试器直接报 Unable to launch JVM。
- 用终端执行
which java和which javac（macOS/Linux）或where java（Windows），确认两者指向同一 JDK 目录下的bin - 在 VS Code 中按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Java: Configure Java Runtime，检查「Java home」是否指向你期望的 JDK 根目录（如/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home） - 如果用了 SDKMAN! 或 jEnv，确保 VS Code 是从终端启动（例如在终端中执行
code .），否则它可能无法继承 shell 的环境变量
Extension 要装全：不只是 Extension Pack for Java
只装 Extension Pack for Java 看似够用，但实际缺一不可——尤其调试时会静默失败。
- 必须启用
Debugger for Java（由 Microsoft 提供），否则点击「Run → Start Debugging」会提示No debug configuration found -
Project Manager for Java负责识别pom.xml或build.gradle，缺失会导致「No Java projects found」，连src文件夹都不高亮 - 如果用 Lombok，得额外装
Lombok Annotations Support for VS Code，否则@Data类型会标红，且断点可能无法停在 getter 方法内 - 禁用任何第三方 Java 语法高亮插件（比如老旧的
Java Extension），它们和官方包冲突，常导致自动补全卡死
launch.json 里 mainClass 必须可解析，不能靠猜
VS Code 不像 IntelliJ 那样自动扫描 public static void main(String[])。如果你没配 launch.json 或写错类名，调试按钮灰掉，或运行时报 ClassNotFoundException。
- 右键 Java 源文件 →
Debug As Java，VS Code 会自动生成.vscode/launch.json，但前提是该文件里确实有合法的main方法；否则它只会报No main class detected - 手动配置时，
mainClass值是**全限定类名**，不是文件路径。例如com.example.App，而不是src/main/java/com/example/App.java - 若项目用 Maven，确保
sourceRoots在launch.json中设为["src/main/java"]，否则断点加载失败，控制台显示Source not found - 避免在
args字段里写带空格的字符串而不加引号，比如"--name=My App"必须写成"--name=My App"（JSON 字符串本身已含引号），否则 JVM 启动参数解析出错
调试时看不到变量值？先查 org.eclipse.jdt.ls.core.projectConfiguration
断点能停，但变量窗全是 Cannot retrieve children，大概率是项目未被 Language Server 正确加载，而非代码问题。
立即学习“Java免费学习笔记（深入）”；
- 打开命令面板，执行
Java: Refresh Projects，强制重载 Maven/Gradle 元数据 - 检查
.vscode/settings.json是否有误配的java.configuration.updateBuildConfiguration，设为"interactive"时，每次改pom.xml都会弹窗，选错就中断索引 - 观察 VS Code 右下角状态栏：如果有黄色感叹号写着
Building workspace，说明 JDT LS 还在扫描，此时打断点无效；等它变成绿色的Ready再调试 - 如果用了模块化（
module-info.java），确保requires java.base;存在，否则 JDT LS 可能拒绝加载该模块下的类
{
"configurations": [
{
"type": "java",
"name": "Launch App",
"request": "launch",
"mainClass": "com.example.App",
"projectName": "my-app",
"sourcePaths": ["src/main/java"],
"console": "integratedTerminal"
}
]
}
最常被跳过的一步：改完 launch.json 或 pom.xml 后，不重启 Java Language Server。按 Ctrl+Shift+P 输入 Java: Restart Language Server，比关掉再开 VS Code 更快见效。
