VSCode 运行 Spring Boot 需三者对齐：正确配置 java.home（JDK 17+ 根目录）、启用 Red Hat 官方 Spring Boot Tools 扩展、配置阿里云 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\❌）
安装并启用 Spring Boot Tools（Red Hat 官方扩展）
很多人装了 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
用 launch.json 配置启动而非依赖右键“Run”
图形化右键菜单看似方便，但传参能力弱、环境隔离差，且容易因 projectName 与 pom.xml 中 <artifactId> 不一致而静默失败。真要稳定运行，必须手写 .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，确保target/classes已生成，否则 launch.json 会找不到字节码
解决 Maven 依赖下载慢或失败
国内用户最常卡在 Resolving dependencies 卡死或报 Could not transfer artifact，这不是 VSCode 问题，而是 Maven 默认中央仓库在国内不可达。
- 修改
~/.m2/settings.xml（没有就新建），在<mirrors>内添加阿里云镜像：
<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>Aliyun Maven</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>
maven.executable.path，填入本地 Maven 的 bin/mvn（Windows 是 mvn.cmd）java.configuration.maven.userSettings，填入你刚改的 settings.xml 路径（如 C:\Users\XXX\.m2\settings.xml）最容易被忽略的是：VSCode 的 Java 语言服务器缓存有时会固化错误配置，导致改了 java.home 或 settings.xml 也没反应。遇到诡异的红波浪线或“无法解析符号”，直接删掉 .vscode 目录 + 重启 VSCode + 重新触发 Java: Configure Java Runtime，比查半天日志更快。
