怎样在vscode中搭建Java开发环境并调试应用【教程】

必须确保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 更快见效。