VSCode Java开发需配置JDK、安装Extension Pack for Java插件、配置Maven、设置launch.json调试参数，并可选装SonarLint等辅助插件以提升效率。
如果您希望在 Visual Studio Code 中进行 Java 开发，但发现无法编译、调试或代码提示失效，则可能是由于 Java 运行环境、语言支持或构建工具未正确配置。以下是完成基础 Java 开发环境搭建所需的关键配置与插件操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并配置 JDK
JDK 是 Java 开发的基础运行时与编译环境，VSCode 本身不自带 Java 编译能力，必须依赖系统已安装的 JDK 并通过设置指向其路径。
1、访问 Oracle 官网或 Adoptium（Eclipse Temurin）下载 JDK 17 或 JDK 21 的 macOS 版本安装包。
立即学习“Java免费学习笔记（深入）”；
2、双击安装包完成安装，默认路径为 /Library/Java/JavaVirtualMachines/jdk-XX.jdk。
3、在终端执行 java -version 与 javac -version 确认命令可用。
4、打开 VSCode 设置（Cmd + ,），搜索 java.home，点击“编辑 in settings.json”，添加键值对："java.home": "/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home"（路径需按实际安装版本调整）。
二、安装核心 Java 插件包
VSCode 原生不支持 Java 语言服务，需通过 Microsoft 官方维护的扩展提供智能感知、跳转、重构、调试等能力，该插件包以捆绑形式分发，确保组件兼容性。
1、在 VSCode 扩展市场中搜索 Extension Pack for Java。
2、点击安装，该包自动包含以下五个必需扩展：Language Support for Java(TM) by Red Hat、Debugger for Java、Test Runner for Java、Project Manager for Java、Visual Studio IntelliCode。
3、安装完成后重启 VSCode，新建 .java 文件，观察左下角是否显示 Java 17 或对应版本标识。
三、配置 Maven 支持
Maven 是 Java 项目依赖管理与构建的标准工具，VSCode 需识别 pom.xml 并加载依赖树，才能实现类自动导入与第三方库跳转。
1、确认系统已安装 Maven：终端执行 mvn -v，若提示 command not found，则需下载 Apache Maven 并将 bin 目录加入 PATH。
2、在 VSCode 中打开含 pom.xml 的文件夹，等待右下角弹出 Import project? 提示，点击“Import”。
3、观察侧边栏是否出现 JAVA PROJECTS 视图，展开后应可见 Referenced Libraries 及所有声明的依赖项。
四、启用 Java 调试功能
调试能力依赖于 Debugger for Java 插件与 launch.json 配置协同工作，需明确指定主类入口与运行参数，否则点击“运行和调试”会报错“Cannot find main class”。
1、在项目根目录创建 .vscode/launch.json 文件（可通过运行面板 → “create a launch.json file” 生成模板）。
2、选择环境为 Java，模板自动生成基本配置。
3、在 configurations 数组中添加一项，确保包含以下字段：\"mainClass\": \"com.example.HelloWorld\"（替换为实际全限定类名）、\"projectName\": \"your-project-name\"（与 pom.xml 中 artifactId 一致）。
4、在 Java 类中设置断点，按 Ctrl+F5 启动调试，观察 VARIABLES 和 DEBUG CONSOLE 输出。
五、优化编码体验的辅助插件
除核心功能外，部分插件可提升日常开发效率，如实时格式化、单元测试快速执行、Lombok 支持等，它们与主 Java 插件无强依赖关系，可按需启用。
1、安装 SonarLint：提供实时代码质量扫描，高亮潜在空指针、资源泄漏等问题。
2、安装 Lombok Annotations Support for VS Code：解析 @Data、@Builder 等注解，使 IDE 能识别自动生成的 getter/setter 方法。
3、安装 Java Test Runner（已在扩展包中，但需手动启用）：在测试类上方出现 Run Test 和 Debug Test 按钮，无需切换到终端执行 mvn test。
