vscode 可高效配置 java 与 spring boot 开发，需严格对齐 jdk 17+、maven/gradle、环境变量及官方扩展；关键步骤包括安装验证 jdk、配置 java_home、安装 java 和 spring boot 扩展包、通过 initializr 创建项目、配置 launch.json 并手动指定 java.home。
在 VSCode 中配置 Java 开发与 Spring Boot 项目是完全可行的，无需安装 IntelliJ IDEA 或 Eclipse，只要装对扩展、配好 JDK 和构建工具，就能获得轻量但高效的开发体验。关键在于：环境变量、JDK 版本、Maven/Gradle 配置、VSCode 扩展三者必须严格对齐，否则会频繁报错（如 The java.home variable is not set、Spring Boot App not recognized 等）。
✅ 第一步：安装并验证 JDK（必须 JDK 17+）
Spring Boot 3.x 要求 JDK 17 或更高版本（Spring Boot 2.7 最高支持 JDK 17，3.2+ 推荐 JDK 17/21）。不要用 JRE，必须是完整 JDK。
- 下载推荐：Adoptium Temurin JDK 17 或 Amazon Corretto 17
- 安装后终端执行：
java -version javac -version
确认输出类似 `17.0.x`。 - 设置系统级
JAVA_HOME（重要！VSCode 默认不读取用户 Shell 的export）：- Windows：系统属性 → 高级 → 环境变量 → 新建
JAVA_HOME，值为C:\Program Files\Eclipse Adoptium\jdk-17.0.x-hotspot -
macOS/Linux：在
~/.zshrc或~/.bash_profile中添加：export JAVA_HOME=$(/usr/libexec/java_home -v 17) export PATH=$JAVA_HOME/bin:$PATH
然后运行 `source ~/.zshrc` 并重启 VSCode。
- Windows：系统属性 → 高级 → 环境变量 → 新建
⚠️ 常见坑：VSCode 启动方式影响环境变量。务必从终端执行 code . 打开项目，否则 JAVA_HOME 可能未加载。
✅ 第二步：安装核心 VSCode 扩展
打开 VSCode → Extensions（Ctrl+Shift+X），安装以下 4 个必需扩展（全部来自 Red Hat 或 Microsoft 官方）：
立即学习“Java免费学习笔记（深入）”；
-
Extension Pack for Java（Red Hat）→ 包含 Language Support、Debugger、Test Runner、Project Manager 等 -
Spring Boot Extension Pack（Pivotal / VMware）→ 提供 Spring Boot Dashboard、YAML 支持、Actuator 查看、启动/调试快捷操作 -
Language Support for Java™ by Red Hat（自动包含在上一个包中，单独确认已启用） -
Project Manager for Java（可选但强烈推荐，方便切换多模块 Maven 项目）
安装后重启 VSCode。
✅ 第三步：创建或导入 Spring Boot 项目
方式一：用 Spring Initializr 快速生成（推荐新手）
访问 https://www.php.cn/link/4ac20f72e05b86b3dc759608b60f5d67 → 选择：
- Project:
Maven Project - Language:
Java - Spring Boot:
3.2.x（匹配你 JDK 版本） - Dependencies:
Spring Web,Spring Boot DevTools,Lombok（可选）
→ Generate → 解压到本地文件夹。
然后在 VSCode 中：File → Open Folder → 选中解压后的根目录（含 pom.xml）。
VSCode 会自动检测为 Java 项目，并弹出提示：“Would you like to import this project?” → 点击 Yes。
方式二：已有 Maven 项目直接打开
确保根目录有 pom.xml，且 <parent></parent> 正确指向 spring-boot-starter-parent，例如：
<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.2.5</version> <relativePath/> </parent>
VSCode 会在右下角显示 “Importing Maven project…” → 等待完成（首次较慢，需下载依赖）。
✅ 第四步：配置 launch.json 启动 Spring Boot 应用
按 Ctrl+Shift+D 打开 Run and Debug → 点击 “create a launch.json file” → 选择 Java → 选择 Spring Boot。
VSCode 将自动生成 .vscode/launch.json，关键字段如下（请核对）：
{
"configurations": [
{
"type": "java",
"name": "Launch Spring Boot App",
"request": "launch",
"mainClass": "com.example.demo.DemoApplication", // 替换为你自己的启动类全限定名
"projectName": "demo", // Maven artifactId，确保与 pom.xml 一致
"env": {
"SPRING_PROFILES_ACTIVE": "dev"
}
}
]
}✅ 启动方式：
- 打开你的
xxxApplication.java文件 - 点击右上角绿色 ▶️ 按钮（或
F5），即可启动 - 控制台输出
Started xxxApplication in X.X seconds即成功
? 小技巧：按 Ctrl+Shift+P → 输入 Spring Boot: Dashboard，可图形化管理所有 Spring Boot 项目、查看 Actuator 端点、启停服务。
最常被忽略但导致 80% 初学者失败的一点：VSCode 的 Java 运行时（java.home）未指向你安装的 JDK 17+。即使系统 java -version 正确，VSCode 可能仍默认用内置 JRE 或旧 JDK。务必手动指定：
-
Ctrl+Shift+P→ 输入Java: Configure Java Runtime→ 在Java Tooling标签下，点击+ Add JDK→ 选择你安装的 JDK 17 目录（如/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home）。
配完后，状态栏左下角应显示 Java 17，且无红色波浪线警告。
