Spring Boot 找不到或无法加载主类的根本原因是 JVM 在 classpath 中找不到指定主类，常见于 JAVA_HOME 配置错误、IDE 运行配置不当、包路径与声明不一致、Maven 构建失败或依赖冲突等。
java.home 配置错一个字符，Spring Boot 就找不到主类
VSCode 不读系统 PATH 或 shell 的 JAVA_HOME，哪怕终端里 java -version 输出 17.0.9，它也可能用着 JRE 或完全没加载 JDK。必须手动指定根目录，且路径不能含 bin 子目录。
- 按
Ctrl+Shift+P→ 输入Java: Configure Java Runtime→ 在Installed JREs下点+→ 选 JDK 根目录（如C:\Program Files\Eclipse Adoptium\jdk-17.0.9+9） - Windows 用户检查系统环境变量
JAVA_HOME值末尾不能有反斜杠：\jdk-17\❌，\jdk-17✅ - macOS/Linux 用户若从桌面图标启动 VSCode，
JAVA_HOME常不生效——务必用终端执行code .打开项目 - 重启 VSCode 后打开任意
.java文件，右下角状态栏显示Java 17才算成功；显示Java (unresolved)表示路径未生效
Spring Boot Tools 必须单独启用，不是装了 Extension Pack 就够
很多人装了 Spring Boot Extension Pack 就以为万事大吉，但真正提供 application.yml 补全、Actuator 端点识别、Dashboard 视图的是其中的 Spring Boot Tools 子模块——它由 Red Hat 发布，需单独确认启用且版本匹配。
- 扩展面板搜
Spring Boot Tools，认准发布者是Red Hat，安装后点击Reload - 打开含
pom.xml的项目根目录，等待右下角弹出Spring Boot project detected；没出现？说明项目未被识别，后续所有功能（如右键 Run）都无效 - 若左侧 Spring Boot 图标（叶子徽标）点开后 Dashboard 空白：右键空白区 →
Refresh Spring Boot Projects - 禁用冲突插件，比如
Java Test Runner和Test Explorer UI同时启用会导致测试图标消失
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>，大小写敏感；否则调试器无法定位 classpath - 首次运行前务必终端执行
mvn clean compile，否则断点无法绑定
Maven for Java 插件不启用，pom.xml 就只是个 XML 文件
VSCode 本身不解析 pom.xml，不装插件点开就纯文本——这不是项目没加载，是根本没触发 Maven 解析。依赖跳不到源码、Run As Spring Boot App 按钮不出现、Java Projects 侧边栏空着，全是这个原因。
立即学习“Java免费学习笔记（深入）”；
- 必须安装 Microsoft 官方
Maven for Java插件（不是 “Maven Helper” 或其他第三方） - 重启 VSCode 后打开项目，等右下角弹出
Import Maven project?→ 点Yes - 若没弹窗，手动执行命令面板 →
Maven: Reload project - 国内用户务必配置阿里云镜像：在 VSCode 设置中指定
maven.terminal.useJavaHome为 true，并在settings.xml中配置mirrorOf为central
java.home、Maven 构建环境的 JDK 版本、pom.xml 中声明的 java.version，缺一不可。任何一个不一致，都会表现为“看起来能跑，但某些功能就是不生效”，而且往往没有明确错误提示。 
