装 Extension Pack for Java 就够了，它集成 Language Support for Java、Debugger for Java、Test Runner for Java、Project Manager for Java 和 Visual Studio IntelliCode 五个必需组件；手动安装单个扩展易导致版本冲突或功能缺失，且安装后必须重启 VSCode 才能激活语言服务器。
装 Extension Pack for Java 就够了，其他单独装的扩展大概率是冗余或冲突源。
只装一个包：为什么是 Extension Pack for Java
这个包不是“锦上添花”，而是 VSCode 跑 Java 的启动开关。它打包了 5 个必须组件：Language Support for Java（语法分析）、Debugger for Java（F5 调试）、Test Runner for Java（JUnit 运行）、Project Manager for Java（识别 pom.xml 或 build.gradle）、Visual Studio IntelliCode（补全增强）。手动凑齐这 5 个，版本不匹配、启用顺序错、依赖漏掉一个，Problems 面板就满屏红色。
常见错误现象：
- 装了
Language Support for Java却无法断点调试 → 缺Debugger for Java - 项目里 import 全标红，但终端
mvn compile正常 → 没装Project Manager for Java，VSCode 根本没把文件夹当 Java 项目 - 状态栏右下角不显示 Java 版本号 → 扩展未真正激活，大概率是没重启 VSCode
java.home 必须指向 JDK 17–21 的根目录
VSCode 的 Java 扩展不读 JAVA_HOME 环境变量，只认自己配置的 java.home。填错路径，语言服务器直接卡在 “Starting Java Language Server…”，连 System.out.println 都没提示。
立即学习“Java免费学习笔记（深入）”；
实操要点：
- 路径必须是 JDK 安装根目录，比如
/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home（macOS）或C:\Program Files\Java\jdk-17.0.2（Windows） - 不能带
/bin，不能是 JRE，不能是 OpenJDK 的精简版（缺javac） - 验证方式：打开设置搜索
java.home，填入后重启 VSCode，再打开任意.java文件，状态栏应立刻显示 “17” 或 “21” - 如果已装过旧版 Java 扩展，先禁用再装
Extension Pack for Java，否则java.home配置项可能被旧扩展锁死
Spring Boot 项目要额外开开关
标准 Java 语言服务器不知道 @SpringBootApplication 是啥，@Autowired 会灰掉，application.yml 里的属性绑定没提示——这不是扩展没装好，是 Spring Boot 支持默认关闭。
必须手动开启：
- 按
Cmd+, / Ctrl+,打开设置 - 搜索
spring boot - 勾选
Spring Boot: Enabled（默认为false） - 改完不用重启，但需等几秒让 Spring Boot Language Server 加载完成
不勾这个，哪怕你项目能跑起来，VSCode 也只当它是普通 Java 类，所有框架级语义支持全部失效。
Maven/Gradle 项目必须手动导入
VSCode 不会自动扫描子目录找 pom.xml。哪怕你打开的是父目录，只要没显式导入，Project Manager for Java 就不工作。
正确做法：
- 打开包含
pom.xml或build.gradle的文件夹（不是整个 Git 仓库根目录） - 右键点击该构建文件 → 选择
Import project - 等待右下角弹出 “Java Projects loaded” 提示，
EXPLORER侧边栏才会出现 Java Projects 视图 - Gradle 项目还需额外装
Gradle for Java（Extension Pack for Java里不包含它）
很多人卡在这一步：以为打开文件夹就等于导入项目，结果所有依赖路径报红，Ctrl+Click 跳不到任何类——其实只是 VSCode 还没开始解析。
最易被忽略的点：Extension Pack for Java 安装后必须重启 VSCode；java.home 和系统 JAVA_HOME 推荐指向同一份 JDK；Spring Boot 开关不点，框架支持就是摆设；项目不手动导入，再全的扩展也白搭。
