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

必须确保java和javac版本一致且VS Code使用同一JDK；装全官方Java扩展；正确配置launch.json的mainClass和sourcePaths；刷新项目并重启Language Server。

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

装对 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。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

右键 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: 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 更快见效。