如何在VSCode中配置Java开发与Spring Boot项目？【教程】

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 FilesEclipse Adoptiumjdk-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。

⚠️ 常见坑：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，且 正确指向 spring-boot-starter-parent，例如：

   org.springframework.boot   spring-boot-starter-parent   3.2.5    

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，且无红色波浪线警告。