vs code 运行 spring boot 项目需三者对齐：jdk（如 jdk 17）、maven、spring 工具链；必须安装 java extension pack 和 spring boot extension pack，并显式配置 java.home 与 maven.executable.path，主类须为 *application.java 且含 @springbootapplication 注解。
VS Code 要跑 Spring Boot，光装扩展不够，必须让 Java 运行时、Maven 和 Spring 工具链三者对齐，否则会卡在“找不到主类”“依赖解析失败”或“调试按钮灰掉”这些地方。
Java Extension Pack 必须装，但不能只靠它
这个包是基础底座，包含 Language Support for Java、Debugger for Java、Maven for Java 等核心组件。没它，VS Code 甚至无法识别 .java 文件里的语法错误。
- 安装后务必重启 VS Code，否则 Java 语言服务器（JLS）不会加载
- 如果状态栏右下角没显示 Java 版本号（比如
Java 17），说明 JDK 没被识别到，不是扩展没装好，而是java.home没配对 - 不要手动去装单独的 “Java Debug Adapter” 或 “Test Runner for Java”——它们已打包进该扩展包，重复安装可能冲突
Spring Boot Extension Pack 是启动和管理的关键
它提供 Spring Initializr 图形向导、Spring Boot Dashboard 项目视图、Spring Boot Tools（自动补全 @ConfigurationProperties 等注解）、YAML 高亮等。没有它，你得手动写 pom.xml、手敲启动命令、在终端里查端口。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 安装后按
Ctrl+Shift+P输入Spring Initializr: Create a Maven Project，才能图形化新建项目 -
Spring Boot Dashboard默认不自动打开，需在侧边栏点击图标（小叶子形状）或按Ctrl+Shift+P→Spring Boot: Open Dashboard - 如果 Dashboard 里看不到你的项目，检查项目根目录是否有
pom.xml且含spring-boot-starter-parent，否则不被识别为 Spring Boot 项目
java.home 和 maven.executable.path 必须显式配置
VS Code 不会自动继承系统环境变量里的 JAVA_HOME 或 MAVEN_HOME，尤其在 macOS/Linux 的 shell 配置（如 ~/.zshrc）生效但 GUI 应用未加载时，VS Code 启动的进程根本看不到这些变量。
- 打开设置（
Ctrl+,），搜索java.home，填入 JDK 根路径，例如：/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home（macOS）或C:\Program Files\Eclipse Adoptium\jdk-17.0.9+9（Windows） - 同样搜索
maven.executable.path，指向mvn或mvn.cmd文件，例如：D:\maven\apache-maven-3.9.6\bin\mvn.cmd - 配置完别忘了关闭并重新打开整个 VS Code 窗口——仅重载窗口或重启服务无效
常见失败点：项目能创建但 Run/Debug 按钮不可用
这通常不是扩展问题，而是项目结构或配置缺失导致 VS Code 无法定位启动入口。
- 确保主类文件名是
*Application.java，且含@SpringBootApplication注解；VS Code 默认只识别这种命名惯例 - 主类必须在
src/main/java下，且包路径与pom.xml中的<groupid></groupid>+<artifactid></artifactid>匹配（例如com.example.demo） - 如果用了 Lombok，要额外装
Lombok Annotations Support扩展，并在设置中开启注解处理：java.configuration.updateBuildConfiguration设为automatic - 首次打开项目时，底部状态栏会出现 “Resolving dependencies…” 提示，等它消失再点运行；强行点击只会报
ClassNotFoundException
真正卡住的地方往往不在“怎么装”，而在“哪个路径写错了一级”或者“哪个配置项漏设了”。特别是 java.home 路径末尾多一个 \bin、少一个 \Contents/Home，都会让整个 Java 支持失效，而且错误提示极其模糊——它不会说“路径错了”，只会静默不工作。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
