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 扩展三者必须严格对齐
，否则会频繁报错（如
、
等）。
✅ 第一步：安装并验证 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
安装后终端执行：
确认输出类似 `17.0.x`。
设置系统级
（重要！VSCode 默认不读取用户 Shell 的
）：
Windows：系统属性 → 高级 → 环境变量 → 新建
，值为
mac
OS/Linux：在
或
中添加：
然后运行 `source ~/.zshrc` 并重启 VSCode。
⚠️ 常见坑：VSCode 启动方式影响环境变量。
务必从终端执行打开项目
，否则
可能未加载。
✅ 第二步：安装核心 VSCode 扩展
打开 VSCode → Extensions（Ctrl+Shift+X），安装以下
4 个必需扩展
（全部来自 Red Hat 或 Microsoft 官方）：
立即学习
“
Java免费学习笔记（深入）
”；
（Red Hat）→ 包含 Language Support、Debugger、Test Runner、Project Manager 等
（Pivotal / VMware）→ 提供 Spring Boot Dashboard、YAML 支持、Actuator 查看、启动/调试快捷操作
（自动包含在上一个包中，单独确认已启用）
（可选但强烈推荐，方便切换多模块 Maven 项目）
安装后重启 VSCode。
✅ 第三步：创建或导入 Spring Boot 项目
方式一：用 Spring Initializr 快速生成（推荐新手）
访问
https://www.php.cn/link/4ac20f72e05b86b3dc759608b60f5d67
→ 选择：
Project:
Language:
Spring Boot:
（匹配你 JDK 版本）
Dependencies:
,
,
（可选）
→ Generate → 解压到本地文件夹。
然后在 VSCode 中：
→ 选中解压后的根目录（含
）。
VSCode 会自动检测为 Java 项目，并弹出提示：“Would you like to import this project?” → 点击
Yes
。
ChatGPT (Windows)
ChatGPT Windows 版本优化了系统兼容性与响应速度，提供多任务处理和对话记录管理功能，适用于办公辅助、创意写作、学习辅导和日常问答。它能帮助用户快速生成文稿、整理资料和高效获取信息，为个人和团队提供稳定、流畅的生产力体验。
下载
方式二：已有 Maven 项目直接打开
确保根目录有
，且
正确指向
，例如：
VSCode 会在右下角显示 “Importing Maven project…” → 等待完成（首次较慢，需下载依赖）。
✅ 第四步：配置 launch.
js
on 启动 Spring Boot 应用
按
打开 Run and Debug → 点击 “create a launch.
json
file” → 选择
Java
→ 选择
Spring Boot
。
VSCode 将自动生成
，关键字段如下（请核对）：
✅ 启动方式：
打开你的
文件
点击右上角绿色 ▶️ 按钮（或
），即可启动
控制台输出
即成功
? 小技巧：按
→ 输入
，可图形化管理所有 Spring Boot 项目、查看 Actuator 端点、启停服务。
最常被忽略但导致 80% 初学者失败的一点：
VSCode 的 Java 运行时（java.home）未指向你安装的 JDK 17+
。即使系统
正确，VSCode 可能仍默认用内置 JRE 或旧 JDK。务必手动指定：
→ 输入
→ 在
标签下，点击
→ 选择你安装的 JDK 17 目录（如
）。
配完后，状态栏左下角应显示
，且无红色波浪线警告。
The java.home variable is not setSpring Boot App not recognizedjava -version
javac -versionJAVA_HOMEexportJAVA_HOMEC:\Program Files\Eclipse Adoptium\jdk-17.0.x-hotspot~/.zshrc~/.bash_profileexport JAVA_HOME=$(/usr/libexec/java_home -v 17)
export PATH=$JAVA_HOME/bin:$PATHcode .JAVA_HOMEExtension Pack for JavaSpring Boot Extension PackLanguage Support for Java™ by Red HatProject Manager for JavaMaven ProjectJava3.2.xSpring WebSpring Boot DevToolsLombokFile → Open Folderpom.xmlpom.xmlspring-boot-starter-parent
org.springframework.boot
spring-boot-starter-parent
3.2.5
Ctrl+Shift+D.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.javaF5Started xxxApplication in X.X secondsCtrl+Shift+PSpring Boot: Dashboardjava -versionCtrl+Shift+PJava: Configure Java RuntimeJava Tooling+ Add JDK/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/HomeJava 17