必须手动配置java.home指向jdk根目录，安装extension pack for java及spring boot tools，确保pom.xml正确加载并从终端执行code .启动项目。
VSCode 不会自动继承系统 JAVA_HOME 或终端里的 PATH，即使 java -version 在终端里能跑，项目照样启动失败、语法不识别、断点不生效——必须手动指定 java.home 路径，并确保 Spring Boot 扩展链完整对齐。
java.home 必须显式配置且指向 JDK 根目录
VSCode 的 Java 扩展（如 Extension Pack for Java）完全不读取系统环境变量，只认 settings.json 里写的 java.home。填错路径、用了 JRE、末尾多加了 /bin，都会导致右下角显示 “Java (unresolved)” 或报错 The JAVA_HOME environment variable does not point to a valid JVM installation。
- 先确认真实 JDK 路径：
which java输出的是 bin 下的可执行文件，要往上退两级（macOS/Linux）或找jdk-17.0.x文件夹根目录；Windows 常见路径是C:\Program Files\Eclipse Adoptium\jdk-17.0.x-hotspot -
java.home值必须是 JDK 安装根目录，不能含/bin，也不能以反斜杠结尾（C:\jdk-17\❌，C:\jdk-17✅） - 改完
settings.json后必须彻底重启 VSCode（不是重载窗口），否则设置不加载 - 重启后打开任意
.java文件，右下角状态栏应明确显示Java 17或类似字样；点击它还能切换已注册的 JDK，但前提是该路径已被java.home或java.configuration.runtimes显式声明过
Spring Boot 项目启动失败：不是 JDK 问题，而是项目未被正确识别
Could not find or load main class 这类错误几乎从不源于 java.home 配置错误，而是 VSCode 没把你的项目当 Spring Boot 项目处理——它压根没加载 Maven 依赖、没扫描启动类、甚至没解析 pom.xml。
- 确保项目根目录存在完整有效的
pom.xml（不是空模板，且含spring-boot-starter-web等 starter） - 右键点击
pom.xml→ 选择Load Project，等待右下角出现Importing Maven project…并完成；若无反应，点 Explorer 上方的⚡刷新按钮 - 启动类（如
Application.java）必须标注@SpringBootApplication，且所在包名需能被默认扫描到（即在默认包或其子包） - 不要右键单个
.java文件点Run——Spring Boot 必须走构建流程；应右键pom.xml→Run As→Maven spring-boot:run，或终端执行mvn spring-boot:run
application.yml 高亮失效、@Autowired 提示缺失：缺 Spring Boot Tools 扩展
只装 Extension Pack for Java 和 Spring Boot Extension Pack 不够，真正提供 YAML 支持、Actuator 端点识别、@ConfigurationProperties 绑定提示的是其中的 Spring Boot Tools 子模块——它由 Red Hat 维护，且必须单独启用。
- 在扩展面板搜索
Spring Boot Tools，确认发布者是Red Hat，安装后点击Reload - 打开含
pom.xml的项目后，等待右下角出现Spring Boot project detected提示；没出现？说明 Spring Boot Tools 没生效或项目结构异常 - 左侧活动栏出现叶子图标（Spring Boot Dashboard），右键空白区 →
Refresh Spring Boot Projects强制重载 - 如果
application.yml仍无高亮或补全，检查文件是否被识别为YAML类型（右下角应显示YAML，不是Plain Text）；必要时右键 →Change Language Mode→ 选YAML
调试时端口冲突、DevTools 不热更：launch.json 不能偷懒用右键菜单
图形化右键菜单（如右键启动类 → Debug）传参能力弱、环境隔离差，且容易因 projectName 与 pom.xml 中定义不一致而静默失败——断点变空心圆、--server.port 不生效、DevTools 不触发都是典型表现。
- 手动创建
.vscode/launch.json，关键字段必须写全： -
mainClass：写全限定名，如com.example.demo.DemoApplication（包名错一个字母就ClassNotFoundException） -
projectName：严格等于pom.xml中的<artifactid></artifactid>，大小写敏感 -
args：只放程序参数，如["--server.port=8081"]；JVM 参数要用vmArgs，如"vmArgs": "-Xmx512m -Dspring.devtools.restart.enabled=true" - 确保
pom.xml中已引入spring-boot-devtools，且 IDE 没禁用自动构建（VSCode 默认关闭，需在设置中搜java.autobuild.enabled开启）
最常被忽略的一点：VSCode 启动方式直接影响环境变量可见性。从桌面图标或 Dock 启动时，它根本读不到你在 ~/.zshrc 里设的 JAVA_HOME；务必从终端执行 code . 打开项目，否则所有手动配置都可能白做。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
