VSCode运行Spring Boot需java.home、Spring Boot Tools和Maven三者严格对齐，缺一不可；java.home须手动指定JDK 17+根目录（非bin），Spring Boot Tools需Red Hat官方版并启用，Maven须正确配置镜像及settings.xml路径。
VSCode 能跑 Spring Boot，但不是装完插件点一下就成——关键在 java.home、Spring Boot Tools 和 Maven 构建环境三者对齐，缺一不可。配错一个，就会卡在“找不到主类”“断点不生效”“依赖红波浪线”上。
确认 JDK 17+ 已被 VSCode 正确识别
终端里 java -version 输出 17 或 21，不代表 VSCode 就能用它。VSCode 启动方式（桌面图标 vs 终端执行 code .）直接影响 JAVA_HOME 是否加载。
- 必须手动指定路径：按
Ctrl+Shift+P→ 输入Java: Configure Java Runtime→ 在Installed JREs下点击+Add JDK→ 选 JDK 根目录（如C:\Program Files\Eclipse Adoptium\jdk-17.0.9+9），不是bin子目录 - 配置后重启 VSCode，打开任意
.java文件，右下角状态栏应显示Java 17；若显示Java (unresolved)，说明路径未生效 - Windows 用户务必检查系统环境变量中
JAVA_HOME是否指向完整 JDK，且值末尾不能带反斜杠（\jdk-17✅，\jdk-17\❌） - 路径含空格或中文（如
C:\Program Files\...）易导致识别失败，建议重装到纯英文无空格路径（如C:\jdk-17）
装对插件并确保 Spring Boot Tools 生效
很多人装了 Spring Boot Extension Pack 就以为够了，但真正提供 application.yml 补全、Actuator 端点识别、Dashboard 视图的是其中的 Spring Boot Tools 子模块——它必须单独启用且版本匹配。
- 在扩展面板搜索
Spring Boot Tools，认准发布者是Red Hat，安装后点击Reload - 打开含
pom.xml的项目根目录，等待右下角出现Spring Boot project detected提示；没出现？说明项目未被识别，后续所有功能（如右键Run）都无效 - 如果 Dashboard 不显示模块：点击左侧
Spring Boot图标（叶子徽标）→ 右键空白区 →Refresh Spring Boot Projects - 别只装
Language Support for Java™ by Red Hat，必须搭配Extension Pack for Java（Microsoft 官方）——漏掉Debugger for Java或Maven for Java，会导致断点不命中、pom.xml不解析
用 launch.json 配置启动而非依赖右键“Run”
图形化右键菜单看似方便，但传参能力弱、环境隔离差，且容易因 projectName 与 pom.xml 中不一致而静默失败。真要稳定运行，必须手写 .vscode/launch.json。
-
mainClass必须写全限定名，如com.example.demo.DemoApplication，包名错一个字母就ClassNotFoundException -
args字段只放程序参数（--server.port=8081），JVM 参数要用vmArgs（如"vmArgs": "-Xmx512m"） -
projectName必须严格等于pom.xml中的<artifactId>，大小写敏感；否则调试器无法定位 class - 激活 profile 要写进
env，例如："env": { "SPRING_PROFILES_ACTIVE": "yun" }，而不是塞进args
资源文件和构建配置常被忽略的细节
application.properties 不生效？devtools 热部署失败？问题大概率不在代码，而在文件位置、编码或构建配置。
-
application.properties或application.yml必须放在src/main/resources/下，不是子目录，也不是src/main/java/ - 从 Windows 复制的文件可能带 BOM，VSCode 默认 UTF-8 但不自动过滤 BOM，导致 Spring Boot 加载失败；可用命令
file -i application.properties检查（Linux/macOS） -
spring-boot-devtools依赖 Maven 构建生效，需确保pom.xml中 scope 是compile（默认），不是test - 热部署失效常见原因：
java.autobuild.enabled关闭、resources目录未被 devtools 监控、OneDrive 实时同步干扰文件变更监听
最麻烦的不是配置项多，而是每个环节都依赖前序环节准确生效——比如 launch.json 写对了，但 java.home 指向错误 JDK，照样报 Unsupported class file major version；又比如 Spring Boot Tools 装了，但 Maven for Java 没启用，Dashboard 就永远是空的。
