VSCode Java开发需安装Java Extension Pack、配置JDK路径、启用Maven/Gradle自动导入、设置格式化与代码操作快捷键、配置launch.json支持JUnit调试。
如果您使用 VSCode 进行 Java 开发，但缺乏合适的插件支持或配置不当，可能导致代码补全失效、调试中断、项目构建失败等问题。以下是针对 Java 开发者在 VSCode 中实现高效开发的多种配置与插件组合方案：
本文运行环境：MacBook Air M2，macOS Sequoia。
一、安装核心 Java 插件套件
VSCode 本身不原生支持 Java，需依赖官方维护的扩展包提供语言服务、调试器与构建工具集成。Java Extension Pack 是由 Microsoft 官方推荐的一体化插件集合，涵盖基础语言支持与关键开发功能。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
立即学习“Java免费学习笔记（深入）”；
2、在扩展市场搜索框中输入 Java Extension Pack。
3、在搜索结果中找到由 Microsoft 发布的扩展，点击“安装”按钮。
4、安装完成后，重启 VSCode 以激活全部子插件（包括 Language Support for Java、Debugger for Java、Project Manager for Java 等）。
二、配置 JDK 路径与工作区设置
VSCode 的 Java 插件需明确识别已安装的 JDK 版本，否则无法启动语言服务器，导致语法高亮、跳转、重构等功能不可用。配置可通过用户级或工作区级 settings.json 实现，优先推荐工作区级配置以保障项目可移植性。
1、在当前 Java 项目根目录下，按下 Cmd+Shift+P 打开命令面板。
2、输入并选择 Preferences: Open Workspace Settings (JSON)。
3、在打开的 settings.json 文件中添加以下键值对：
"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"
4、确保路径指向本地已安装的 JDK 17 或更高版本（可通过终端执行 /usr/libexec/java_home -V 查看可用 JDK 列表）。
三、启用 Maven 或 Gradle 项目自动导入
VSCode 的 Project Manager for Java 插件支持从 pom.xml 或 build.gradle 自动解析依赖与模块结构，但默认可能处于禁用状态。启用后可实时同步源码路径、类路径与测试配置。
1、按下 Cmd+Shift+P，输入并选择 Java: Configure Classpath。
2、在弹出的选项中选择当前项目根目录下的 pom.xml 或 build.gradle 文件。
3、等待右下角出现 Importing project... 提示，直至状态变为 Ready。
4、若未自动触发，可手动点击侧边栏“JAVA PROJECTS”视图中的刷新按钮（循环箭头图标）。
四、配置常用快捷键与编辑行为
默认快捷键常与 macOS 系统或其它插件冲突，需针对性调整以匹配 Java 开发高频操作习惯，例如快速生成 getter/setter、重写方法、格式化代码等。
1、按下 Cmd+, 打开设置界面，在右上角点击“打开 settings.json”图标。
2、在 JSON 中添加如下覆盖项：
"editor.formatOnSave": true,
"java.format.settings.url": "./.eclipse-formatter.xml",
"editor.codeActionsOnSave": {"source.organizeImports": true}
3、如需自定义快捷键，按下 Cmd+K Cmd+S 进入键盘快捷方式设置，搜索 Java: Generate Getters and Setters 并绑定至 Option+Cmd+G。
五、启用远程调试与 JUnit 测试支持
VSCode 支持通过标准 JDWP 协议连接本地或远程 JVM 进程，同时可直接运行 JUnit 5 测试类并展示结果树。该能力依赖 Debugger for Java 插件与 launch.json 配置协同生效。
1、在项目根目录下创建 .vscode/launch.json 文件（可通过命令面板选择 Java: Create a launch.json file 自动生成）。
2、在 configurations 数组中添加如下条目：
{"type": "java","name": "Debug Unit Tests","request": "launch","mainClass": "org.junit.platform.console.ConsoleLauncher","args": ["--class-path", "${workspaceFolder}/target/classes:${workspaceFolder}/target/test-classes","--scan-class-path"]}
3、在任意测试类中右键，选择 Debug Test 即可启动并进入断点。
