初学者可在VSCode中快速搭建运行Spring Boot项目:安装Java和Spring Boot扩展包、配置JDK 17+与Maven、用Spring Initializr创建项目、设置Java运行环境、直接调试主类并访问/actuator/health验证。

如果您刚接触Java开发,希望在VSCode中快速搭建并运行Spring Boot项目,则可能面临环境配置复杂、依赖管理困难等问题。以下是完成此任务的具体步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装必要扩展与工具
VSCode本身不原生支持Java和Spring Boot开发,需通过扩展增强功能,并依赖外部JDK和构建工具提供编译与运行能力。
1、打开VSCode,点击左侧活动栏的扩展图标(或按快捷键Ctrl+Shift+X)。
立即学习“Java免费学习笔记(深入)”;
2、在搜索框中输入Extension Pack for Java,找到由Microsoft发布的官方扩展包,点击安装。
3、继续搜索并安装Spring Boot Extension Pack,该包包含Spring Initializr支持、YAML语法高亮等关键组件。
4、确保系统已安装JDK 17或更高版本,可在终端执行java -version验证;若未安装,请前往Adoptium官网下载Temurin JDK。
5、安装Maven或Gradle任一构建工具,推荐使用Maven,其mvn -v命令应能正常输出版本信息。
二、使用Spring Initializr创建新项目
Spring Initializr是官方推荐的项目初始化服务,可通过VSCode插件直接调用,避免手动配置pom.xml或build.gradle。
1、按下Cmd+Shift+P(Mac)打开命令面板,输入并选择Spring Initializr: Create a Maven Project。
2、依次选择Spring Boot版本(建议选3.2.x)、项目元数据(Group、Artifact、Package name等)。
3、在依赖选择界面,勾选Spring Web和Spring Boot DevTools,其他按需添加。
4、指定项目保存路径,完成后VSCode将自动下载依赖并生成标准目录结构。
三、配置Java运行环境
VSCode需明确识别JDK位置,否则无法解析Java语法、启动类或调试程序。
1、在项目根目录下按下Cmd+Shift+P,输入并选择Java: Configure Classpath。
2、在弹出的JSON配置窗口中,确认"java.home"字段指向已安装的JDK路径,例如/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home。
3、关闭并重新打开VSCode窗口,等待Java语言服务器完成初始化,状态栏右下角应显示Java 17且无红色波浪线警告。
四、运行与调试Spring Boot应用
VSCode支持零配置启动Spring Boot主类,同时提供断点调试能力,无需额外插件即可完成基础开发闭环。
1、在src/main/java目录下找到以Application结尾的主类(如MyApplication.java)。
2、将光标置于public static void main方法内部,点击左侧编辑器边缘出现的绿色三角形图标,选择Debug。
3、启动成功后,终端将输出Tomcat started on port(s): 8080,表示内嵌Web服务器已就绪。
4、打开浏览器访问http://localhost:8080/actuator/health,返回{"status":"UP"}即代表应用健康运行。










