直接安装 Microsoft 官方的 Extension Pack for Java 即可，它已集成 Language Support for Java、Debugger for Java 等全部核心组件，版本严格对齐，避免手动混装导致的 Language Server 启动失败或 ClassNotFoundException 错误。
直接装 Extension Pack for Java 就够了，别手动凑单
绝大多数 Java 开发者不需要逐个安装 Language Support for Java、Debugger for Java 等插件。微软官方打包的 Extension Pack for Java 已经包含全部核心组件，且版本间严格对齐——手动混装不同发布周期的独立插件，极易触发 Java Language Server 启动失败或 ClassNotFoundException 错误。
常见错误现象包括：Cannot resolve class 'Object'、调试器断点灰色不可用、Maven 依赖不自动下载。
- 安装前确认已安装 JDK 17+（JDK 21 更稳妥），并能通过终端运行
java -version - 在 VSCode 扩展面板搜索
Extension Pack for Java，认准发布者是Microsoft，不是 Red Hat 或其他同名变体 - 安装后无需重启，但首次打开 .java 文件会触发后台语言服务器初始化（观察右下角状态栏是否显示
Java Language Server: Starting...）
java.home 配置必须写对路径，Windows 和 macOS 差异很大
java.home 不是环境变量 JAVA_HOME 的简单复刻，它必须指向 JDK 根目录（含 bin、lib 子目录），不能指向 JRE，也不能多一层 jdk-17.0.2 这样的子文件夹。
典型错误路径：C:Program FilesJavajdk-17.0.2jre（错在末尾多了 jre）、/Library/Java/JavaVirtualMachines（错在没进具体版本子目录）。
立即学习“Java免费学习笔记（深入）”；
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- Windows 示例：
"java.home": "C:\Program Files\Java\jdk-21"（注意双反斜杠转义） - macOS 示例：
"java.home": "/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home" - Linux 示例：
"java.home": "/usr/lib/jvm/java-21-openjdk-amd64" - 配置位置：打开
settings.json（命令面板输入Preferences: Open Settings (JSON)），不要写在用户设置里覆盖工作区设置
Maven 项目识别失败？检查 pom.xml 是否在根目录
VSCode 的 Java 插件默认只扫描打开文件夹的顶层 pom.xml。如果项目结构是 myproject/backend/pom.xml，而你打开的是 myproject 文件夹，插件根本不会加载 backend 模块——这不是插件 bug，是设计如此。
表现是：无代码补全、src/main/java 不标为源码根、mvn clean compile 在终端能跑，但 VSCode 内部不识别依赖。
- 正确做法：用 VSCode 直接打开含
pom.xml的最小子目录（如backend），而非整个多模块父目录 - 若必须打开父目录，可在
.vscode/settings.json中显式声明："java.configuration.updateBuildConfiguration": "interactive"，保存后点击弹窗中的 “Yes” 强制刷新 - 避免使用
mvn archetype:generate生成后直接打开，先 cd 进生成的子目录再用 code .
调试时断点不生效？先关掉 spring-boot-devtools
Spring Boot 项目启用 spring-boot-devtools 后，类加载器会被重写，导致 VSCode 调试器无法将源码行号与实际字节码对齐——断点变成空心圆，hover 显示 Source not found。
这不是插件配置问题，而是 JVM 类加载机制冲突。即使 launch.json 写得完全正确，也会失效。
- 临时解决：在
pom.xml中注释掉spring-boot-devtools依赖，重启调试 - 长期方案：改用
spring-boot-devtools的远程调试模式，或换用HotswapAgent替代 - 验证方式：启动后查看控制台日志，若含
DevToolsApplicationListener字样，说明 devtools 已激活
真正卡住人的从来不是插件装不装，而是 JDK 路径少一个字符、pom.xml 放错一层、或者 devtools 在后台悄悄改了类加载顺序——这些细节不报错，但让所有高级功能静默失效。
