必须安装并启用microsoft官方“maven for java”插件，重启后导入maven项目；确保java.home配置与pom.xml中java.version一致；开启java.autobuild.enabled；devtools需配合maven构建生效。
Spring Boot项目在VSCode里打不开pom.xml？先确认Maven插件已启用
VSCode本身不内置Maven支持，pom.xml只是个普通XML文件，点开就显示源码——这不是项目没加载，是根本没触发Maven解析。必须装官方 Maven for Java 插件（由Microsoft发布），且确保它处于启用状态。
常见错误现象：ctrl+click 依赖跳不到源码、Run As Spring Boot App 按钮不出现、Java Projects 侧边栏空着。
- 检查插件列表里有没有
Maven for Java（不是“Maven Helper”或第三方同类） - 重启VSCode后，打开含
pom.xml的文件夹，等待右下角弹出“Import Maven project?”提示，点“Yes” - 如果没弹窗，手动执行命令面板（
Ctrl+Shift+P）→ 输入Maven: Reload project
启动类找不到SpringBootApplication注解？检查Java版本和spring-boot-starter-parent继承
VSCode的Java支持依赖java.home配置和项目级JDK绑定。即使系统装了JDK 17，pom.xml里若指定java.version为11，而你又没在VSCode里告诉它用哪个JDK，就会报@SpringBootApplication无法解析——本质是编译器版本和Spring Boot版本不匹配。
使用场景：新建Spring Initializr项目后直接导入VSCode，但启动类标红。
- 确认
pom.xml中<parent></parent>指向有效的spring-boot-starter-parent（如3.2.0对应Java 17+） - 在VSCode设置里搜
java.home，设为与pom.xml中java.version一致的JDK路径（比如/usr/lib/jvm/jdk-17） - 删掉项目根目录下的
.vscode/settings.json（如果存在旧配置干扰）
运行时报Command failed: java -version？别信终端里能跑就代表VSCode能跑
VSCode的Java扩展默认读取系统PATH，但macOS和Linux下常因shell配置（如~/.zshrc）未被GUI进程加载，导致VSCode启动时根本找不到java命令——哪怕你在iTerm里敲java -version一切正常。
性能影响：这个问题会导致所有Java相关功能瘫痪，不只是运行失败，连代码补全、错误检查都失效。
- Mac用户：在
~/Library/Application Support/Code/User/settings.json里加"java.configuration.runtimes"显式声明JDK路径 - Linux用户：启动VSCode时用
env PATH=$PATH code --no-sandbox保证环境变量透传 - Windows用户：检查系统环境变量
JAVA_HOME是否指向JDK根目录（不是JRE），且%JAVA_HOME%\bin在PATH最前面
热部署spring-boot-devtools不生效？VSCode保存≠Maven编译
很多人以为改完代码Ctrl+S就自动重载，结果发现断点不进、页面没更新。根本原因是VSCode默认不开启自动构建，devtools监听的是target/classes目录变化，而你改完Java文件后，VSCode根本没调用mvn compile。
容易踩的坑：开了File → Auto Save，误以为这就够了；或者装了Build on Save插件，但没配对Maven任务。
- 打开VSCode设置，搜
java.autobuild.enabled，设为true - 确保
pom.xml里spring-boot-devtools的<optional></optional>是false（默认值） - 启动时用
Spring Boot Dashboard插件点“Run”，别直接右键main()方法——后者绕过Maven生命周期，class文件不会进target
真正卡住人的地方往往不在配置项本身，而在VSCode的Java扩展和Maven插件之间那层隐式协作关系——它们各自缓存、各自读环境变量、各自决定何时触发重建。多一个Reload project，少一个settings.json里的冲突字段，差的就是能不能跑起来。
