Java版本与java.home必须严格匹配，Spring Boot 3.x要求JDK 17+，VS Code中java.home配置错误会导致spring-boot:run报Unsupported class file major version。
Java版本和java.home必须严格匹配
Spring Boot项目启动失败，80%是因为VS Code里java.home指向了错误的JDK版本。比如你用的是Spring Boot 3.x，它强制要求JDK 17+，但VS Code默认可能还连着JDK 8或11——这时Maven能编译过，spring-boot:run却直接报Unsupported class file major version。
- 打开VS Code设置（
Ctrl+,），搜java.home，手动设为JDK 17或21的jdk-17.0.x/bin目录（Windows）或Contents/Home（macOS） - 别信“自动检测”——它常把JRE或旧JDK当首选；务必点开路径确认
java -version输出与Spring Boot文档要求一致 - 项目根目录下加
.vscode/settings.json，硬编码锁定："java.configuration.runtimes": [ { "name": "JavaSE-17", "path": "/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home" } ]
spring-boot-devtools热更失效？检查类路径和插件冲突
改完Controller代码按保存没反应，控制台也没Restarting due to changes...——大概率是类路径没被devtools监控，或者Lombok、MapStruct等注解处理器干扰了字节码重载。
- 确保
pom.xml里spring-boot-devtools的runtime，不是provided或漏写 - VS Code的Java插件默认禁用自动构建，去设置里开
java.autobuild.enabled，并确认java.configuration.updateBuildConfiguration设为interactive - 如果用了Lombok，必须在VS Code安装
Lombok Annotations Support for VS Code插件，否则@Data生成的getter/setter不会进热更范围
Maven依赖不识别？别只刷新Project，先看settings.xml生效位置
明明pom.xml写了mybatis-spring-boot-starter，但@Mapper标红、MyBatisAutoConfiguration找不到——问题常出在Maven配置没被VS Code读到。
- VS Code Java插件只认
~/.m2/settings.xml或项目级./mvnw同目录下的settings.xml，不读IDEA专属的conf/settings.xml - 私有仓库地址、镜像源、
profile激活状态，全得在这两个位置配；配错一个字符，maven-dependency-plugin就拉不到依赖 - 右键项目→
Reload project后，看底部状态栏是否显示Importing Maven project...完成，没这个提示说明根本没触发解析
调试时断点不命中？重点查launch.json的mainClass和projectName
打好了断点，F5跑起来却跳过——常见原因是VS Code没把启动类当成主类，而是去执行了Maven Wrapper或测试类。
-
.vscode/launch.json里mainClass必须填完整类名，比如com.example.demo.DemoApplication，不能只写DemoApplication - 如果项目是多模块，
projectName字段要明确指定子模块名（如demo-web），否则VS Code可能加载父POM的空jar - Spring Boot 3默认启用
spring.main.banner-mode=off，但调试时建议临时关掉这个配置，方便确认JVM是否真从你指定的类启动
Spring Boot对环境一致性极其敏感，VS Code里一个路径斜杠方向不对、一个JDK小版本差0.1，都可能让整个流程卡在某个无声的环节。与其反复重启插件，不如先用java -version和mvn -v在终端里确认基础链路通不通。
