在 Windows 11 上使用 VSCode 开发 Spring Boot 项目，核心思路是：VSCode 本身只是一个编辑器，需要借助扩展插件和外部工具链（JDK、Maven）来提供 Java/Spring Boot 支持。以下是完整的配置流程：

一、环境准备

1.安装 JDK

推荐使用 JDK 17 或 JDK 21（Spring Boot 3.x 的最低要求）。citeweb_search#6web_search#1

• 从 Oracle 官网 或 Adoptium 下载安装。
• 配置环境变量：
  • 新建系统变量 JAVA_HOME，值为 JDK 安装路径（如 C:\Program Files\Java\jdk-17）
  • 在 Path 中添加 %JAVA_HOME%\bin
• 验证：在 CMD 中执行 java -version 和 javac -version

2.安装 Maven

• 从 Maven 官网 下载二进制包，解压到无中文无空格的路径（如 D:\apache-maven-3.9.x）。
• 配置环境变量：
  • 新建系统变量 MAVEN_HOME，值为解压路径
  • 在 Path 中添加 %MAVEN_HOME%\bin
• 验证：mvn -v
• 配置本地仓库（可选）：修改 conf/settings.xml 中的 <localRepository>，建议放在非 C 盘。

3.安装 VSCode

• 从 VSCode 官网 下载安装（不建议从微软商店安装，可能存在权限兼容问题）。citeweb_search#4
• 安装时建议勾选“添加到 PATH”，方便命令行启动。

二、安装 VSCode 扩展

打开 VSCode，按 Ctrl+Shift+X 进入扩展市场，安装以下两组扩展包：

扩展包 包含的核心扩展 作用
Extension Pack for Java Language Support for Java by Red Hat、Debugger for Java、Maven for Java 等 提供 Java 语言支持、调试、Maven 集成
Spring Boot Extension Pack Spring Boot Tools、Spring Initializr Java Support、Spring Boot Dashboard 提供 Spring Boot 项目创建、运行、调试支持

citeweb_search#14web_search#5

安装完成后，重启 VSCode 确保扩展生效。

三、配置 VSCode 的 Java 环境

1.配置 JDK 路径

按 Ctrl+Shift+P 打开命令面板，输入 Preferences: Open User Settings (JSON)，添加：

{
    "java.configuration.runtimes": [
        {
            "name": "JavaSE-17",
            "path": "C:\\Program Files\\Java\\jdk-17",
            "default": true
        }
    ],
    "java.configuration.detectJdksAtStart": false
}

citeweb_search#14

路径请替换为你实际的 JDK 安装路径。如果安装了多个 JDK，可以按上述格式添加多个。

2.配置 Maven 路径（可选）

如果使用系统全局 Maven，可在 User Settings 中添加：

{
    "maven.executable.path": "D:\\apache-maven-3.9.x\\bin\\mvn.cmd"
}

citeweb_search#14

四、创建 Spring Boot 项目

方法一：使用 Spring Initializr（推荐）

1. 按 Ctrl+Shift+P 打开命令面板
2. 输入 Spring Initializr: Create a Maven Project
3. 按提示选择：
   • Spring Boot 版本：选择稳定版（如 3.2.x 或 3.3.x）
   • 语言：Java
   • Group Id：如 com.example
   • Artifact Id：如 demo
   • 打包方式：Jar（推荐）或 War
   • Java 版本：17 或 21
   • 依赖：至少选择 Spring Web（开发 Web 应用）
4. 选择项目保存目录，点击 Generate into folder
5. 生成完成后，点击提示中的 Open 打开项目

citeweb_search#5web_search#1

方法二：导入已有项目

直接将项目文件夹拖拽到 VSCode，或 文件 -> 打开文件夹 选择项目根目录（包含 pom.xml 的文件夹）。VSCode 会自动识别为 Maven 项目并下载依赖。

五、项目结构与运行

项目结构

demo/
├── .vscode/              # VSCode 配置文件
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/demo/
│   │   │       └── DemoApplication.java   # 主启动类
│   │   └── resources/
│   │       └── application.properties     # 配置文件
│   └── test/
├── pom.xml               # Maven 依赖管理
└── ...

运行项目

方式 1：Spring Boot Dashboard（最方便）

1. 点击左侧边栏的 Spring 图标（Spring Boot Dashboard）
2. 找到你的项目，点击 ▶ 播放按钮 运行
3. 或右键项目选择 Run / Debug

citeweb_search#5web_search#18

方式 2：终端命令

按 Ctrl+` 打开终端，执行：

mvn spring-boot:run

方式 3：调试模式

1. 在代码左侧行号处点击设置断点
2. 打开左侧调试图标（Ctrl+Shift+D）
3. 选择配置 Debug (Launch) - Current File 或创建 launch.json：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "Spring Boot Debug",
            "request": "launch",
            "mainClass": "com.example.demo.DemoApplication",
            "projectName": "demo"
        }
    ]
}

citeweb_search#5

六、编写第一个接口

在 src/main/java/com/example/demo/ 下创建 HelloController.java：

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello, Spring Boot on VSCode!";
    }
}

启动项目后，浏览器访问 http://localhost:8080/hello 即可看到返回结果。

citeweb_search#7web_search#6

七、常见问题排查

总结

在 Windows 11 + VSCode 上搭建 Spring Boot 开发环境的关键步骤：

1. 安装 JDK 17+ 和 Maven，配置好环境变量
2. 安装 Java Extension Pack 和 Spring Boot Extension Pack
3. 在 VSCode 中配置 JDK 和 Maven 路径
4. 使用 Spring Initializr 创建项目
5. 通过 Spring Boot Dashboard 或终端运行项目

相比 IntelliJ IDEA，VSCode 更轻量，启动更快，适合中小型 Spring Boot 项目的开发。citeweb_search#18