vscode 搭建 java 开发环境需装三个核心扩展：extension pack for java、project manager for java、gradle for java（若用 gradle）；正确配置 java_home 指向 jdk 并匹配项目版本；spring boot 项目须启用 spring boot: enabled 设置。
VSCode 本身不是 Java IDE，所谓“完美 Java 开发环境”取决于你实际要做什么：写 Spring Boot？调试 Android？还是只跑个 Main.java？没有统一答案，但有明确的最小可行组合——装错扩展反而会让项目加载失败、智能提示失灵、甚至 java 命令都报红。
必须装的三个核心扩展（缺一不可）
VSCode 的 Java 支持靠的是“语言服务器 + 构建工具集成 + 运行时桥接”三层协作，少一层就卡在某个环节：
-
Extension Pack for Java（官方打包，含Language Support for Java、Debugger for Java、Test Runner for Java等）——提供语法高亮、跳转、补全、断点调试基础能力 -
Project Manager for Java（微软官方）——识别pom.xml或build.gradle，自动导入 Maven/Gradle 项目；不装它，VSCode 会把整个文件夹当普通文本目录，import全标红 -
Java Extension Pack里已包含Maven for Java，但如果你用 Gradle，必须额外装Gradle for Java（注意不是 “Gradle Tasks”，那个只是任务面板，没项目解析能力）
PATH 和 JAVA_HOME 配置错误是 90% 的“无法启动语言服务器”原因
VSCode 的 Java 扩展不会读系统默认 JDK，它严格依赖 JAVA_HOME 环境变量指向一个 JDK（不是 JRE），且该 JDK 版本需与项目 sourceCompatibility 匹配。常见症状：Language Support for Java 启动失败、状态栏显示 “Starting Java Language Server…” 卡死、Problems 面板里全是 Unresolved compilation problem。
- Windows 用户：在系统环境变量中设置
JAVA_HOME为C:\Program Files\Java\jdk-17这类完整路径，**不能带 bin 子目录** -
macOS/Linux：在
~/.zshrc或~/.bash_profile中写export JAVA_HOME=$(/usr/libexec/java_home -v 17)，然后source它；别用which java的结果赋值 - 验证方式：终端里运行
$JAVA_HOME/bin/java -version，再重启 VSCode —— 不重启，扩展不重读变量
Spring Boot 项目需要额外启用支持（否则注解全灰、@Autowired 报错）
Spring 的组件扫描、条件装配、配置绑定这些能力，标准 Java 语言服务器压根不知道。必须打开 Spring Boot 特性开关：
立即学习“Java免费学习笔记（深入）”；
- 打开 VSCode 设置（
Cmd+, / Ctrl+,），搜索spring boot - 勾选
Spring Boot: Enabled（默认是 false） - 如果用了 Lombok，还要手动在设置里加
"java.configuration.updateBuildConfiguration": "interactive"，否则@Data生成的 getter/setter 不被识别 - 注意：Spring Boot 扩展（
Spring Boot Extension Pack）和 Java 扩展包是两个独立包，前者不包含后者，必须共存
最常被忽略的是：Java 扩展对多模块 Maven 项目的父 pom.xml 解析很弱，如果子模块没单独打开文件夹，而是只开根目录，src/main/java 下的类可能不被索引——这时得右键子模块目录 → “Add Folder to Workspace”，而不是靠自动发现。
