VSCode运行Spring Boot需java.home、Spring Boot Tools和Maven三者严格对齐：必须手动指定JDK 17+根目录（非bin）、启用Red Hat官方Spring Boot Tools插件、项目根目录含pom.xml并识别成功；终端java -version有效不等于VSCode可用，须通过Java: Configure Java Runtime设置路径并重启验证右下角状态栏显示Java 17。
VSCode 能跑 Spring Boot，但不是装完插件点一下就成——关键在 java.home、Spring Boot Tools 和 Maven 构建环境三者对齐，缺一不可。
怎么确认 VSCode 真的用了 JDK 17+？
终端里 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 Dashboard 不显示项目？
很多人装了 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 配置后还是找不到主类？
图形化右键菜单看似方便，但传参能力弱、环境隔离差，且容易因 projectName 与 pom.xml 中不一致而静默失败。真要稳定运行，必须手写 .vscode/launch.json。
立即学习“Java免费学习笔记（深入）”；
-
mainClass必须写全限定名，如com.example.demo.DemoApplication，包名错一个字母就ClassNotFoundException -
args字段只放程序参数（--server.port=8081），JVM 参数要用vmArgs（如"vmArgs": "-Xmx512m"） -
projectName必须严格等于pom.xml中的<artifactId>，大小写敏感；否则调试器无法定位 classpath，断点变空心圆 - 首次运行前务必在终端执行
mvn clean compile，确保target/classes已生成，否则launch.json会找不到字节码
为什么 application.properties 不生效？
Spring Boot 启动时找不到配置，报 Failed to load property source from location 'classpath:/application.properties'，90% 是路径或编码问题。
-
application.properties或application.yml必须置于src/main/resources目录下，不能放在src/main/java或子目录里 - 文件必须是 UTF-8 编码且无 BOM；用 VSCode 打开后右下角查看编码格式，若显示
UTF-8 with BOM，点击切换为UTF-8并保存 - 如果用 Lombok，确认
pom.xml中lombok依赖scope为provided，并在 VSCode 设置中启用 annotation processing（命令面板运行Java: Configure Classpath→ 勾选Enable annotation processing） - 不要直接右键运行
.java文件——Spring Boot 必须通过 Maven 构建后启动；应右键pom.xml→Run As→Maven spring-boot:run，或终端中执行mvn spring-boot:run
最常被忽略的一点：VSCode 启动方式决定环境变量是否加载。从桌面图标启动时，JAVA_HOME 和 M2_HOME 往往不生效，必须用终端执行 code . 打开项目，否则所有配置都可能白搭。
