VSCode - 搭建SpringBoot开发环境详细教程（附：热部署配置）

作者：hangge | 2026-06-05 08:57

相较于 IDEA，VSCode 轻量化、启动速度快、占用资源少，搭配官方 Java 与 SpringBoot 插件，完全能满足日常 SpringBoot 项目开发、调试、运行需求。本文将演示如何从零搭建完整的 VSCode SpringBoot 开发环境，适配 SpringBoot 3.x 最新版本。

1，JDK 安装与环境变量配置

SpringBoot 3.x 强制要求 JDK17 及以上，推荐 OpenJDK17（Adoptium），免费开源、适配性最强。具体安装步骤可以参考我之前写的文章：

Java - Windows 下 JDK 安装、环境配置教程（附：官方下载地址）

2，安装 Maven

Maven 建议使用 3.8+ 版本，用于项目依赖管理，具体安装方法可以参考我之前写的文章：

Java - Windows 下 Maven 的安装、配置教程（配置本地仓库路径、阿里云镜像加速）

3，VSCode 插件安装

（1）首先安装“Extension Pack for Java”这个插件。这个是微软官方 Java 开发插件包，集成了语法提示、代码补全、编译、运行、项目管理等所有 Java 基础能力，是 SpringBoot 开发的前置核心插件。

（2）接着还要安装“Spring Boot Extension Pack”插件。这个是 Spring 官方专属插件包，集成项目创建、配置文件提示、端点监控、热部署支持、项目运行调试等 SpringBoot 专属功能，是开发核心插件。

4，配置 Maven

使用快捷键 Ctrl + , 打开 VSCode 设置，搜索 maven path，然后自定义本地 Maven 路径，以及 Maven 配置文件路径。

Maven 路径：E:\apache-maven-3.9.16\bin\mvn.cmd
Maven 配置文件路径：E:\apache-maven-3.9.16\conf\settings.xml

（1）使用快捷键 Ctrl + , 打开 VSCode 设置，搜索 maven.settingsFile，点击“Editin settings.json”

（2）添加如下配置指定本地 Maven 的执行文件路径以及 settings.xml 文件位置。

{
    // 自定义本地Maven路径（无本地Maven可删除此行，使用内置Maven）
    "maven.executable.path": "E:\\apache-maven-3.9.16\\bin\\mvn.cmd",
    // 指定Maven配置文件
    "maven.settingsFile": "E:\\apache-maven-3.9.16\\conf\\settings.xml",
    // 自动导入Maven依赖
    "maven.import.autoEnabled": true
}

5，创建第一个 SpringBoot 项目

（1）VSCode 可通过内置 Spring Initializr 快速创建标准 SpringBoot 项目，无需访问网页版，操作更便捷：

首先使用快捷键 Ctrl + Shift + P 打开命令面板
输入并选择 Spring Initializr: Create a New Maven Project

（2）然后选择 SpringBoot 版本，比如我这里选择 3.5.14。

（3）接着选择开发语言：Java

（4）然后填写项目 Group

（5）接下来填写 Artifact（项目名）

（6）然后填写项目包名。

（7）接下来打包方式选择 Jar 即可。

（8）选择 Java 版本，这里我们选择 17

（9）接下来勾选需要的项目依赖，其中 Spring Web 是必须勾选的，这个是 Web 开发核心依赖，包含接口开发、Tomcat 容器。

（10）最后选择项目保存路径，等待项目初始化完成。

6，编写测试接口并运行项目

（1）在主类同级包下新建 TestController.java，编写简单接口用于测试项目是否正常运行，代码如下：

package com.hangge.demo;

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

@RestController
public class TestController {

    @GetMapping("/hello")
    public String hello() {
        return "欢迎访问hangge.com";
    }
}

（2）接着启动运行项目，VSCode 提供两种便捷启动方式。一种是打开项目启动主类，右键选择 Run Java 即可启动项目。

（3）另一种方式是左侧找到 SpringBoot 插件面板，直接点击项目启动按钮。

（4）启动后打开浏览器，访问地址：http://localhost:8080/hello，页面输出如下信息，说明环境完全搭建成功。

附：配置热部署

1，添加热部署依赖

热部署可实现代码修改后无需重启项目自动生效，大幅提升开发效率。首先我们在项目的 pom.xml 中添加 devtools 依赖。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <scope>runtime</scope>
    <optional>true</optional>
</dependency>

2，开启 VSCode 自动编译

打开设置，搜索 Java: Auto Build，开启自动构建。

3，运行测试

上面两步设置完成后，修改代码保存即可自动触发项目热更新，无需手动重启。

其他