在 VS Code 中运行 Java Spring Boot 项目的完整指南

Visual Studio Code 作为一款轻量级但功能强大的代码编辑器，通过安装合适的扩展插件，完全可以胜任 Java Spring Boot 项目的开发工作。本文将详细介绍在 VS Code 中配置和运行 Spring Boot 项目的完整流程。

环境准备

安装必要的扩展

首先需要安装以下 VS Code 扩展：

• Java Extension Pack：包含 Java 语言支持、调试器等核心功能
• Spring Boot Extension Pack：提供 Spring Boot 专属支持和仪表板功能

这些扩展可以通过 VS Code 的扩展市场直接搜索安装。

配置开发环境

确保系统中已安装以下软件：

• Java Development Kit (JDK)：推荐 JDK 11 或更高版本
• Maven：用于项目构建和依赖管理
• Spring Boot CLI（可选）：用于快速创建项目

项目创建与导入

创建新的 Spring Boot 项目

1. 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）
2. 输入 "Spring Initializr: Generate a Maven Project" 并选择
3. 按照提示配置项目参数（Group、Artifact、依赖等）
4. 选择项目生成位置并确认创建

导入现有项目

直接将项目文件夹拖拽到 VS Code 窗口即可，编辑器会自动检测项目类型并提示安装相关扩展。

调试配置

配置启动文件

1. 打开调试视图（点击侧边栏调试图标或按 Ctrl+Shift+D）
2. 点击"创建 launch.json 文件"
3. 选择 Java 作为环境

VS Code 会在项目根目录的 .vscode 文件夹中生成 launch.json 文件：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "java",
      "name": "Debug (Launch) - Current File",
      "request": "launch",
      "mainClass": "${file}"
    },
    {
      "type": "java",
      "name": "Debug (Launch) - MyApp",
      "request": "launch",
      "mainClass": "com.example.MyApp",
      "projectName": "my-app"
    }
  ]
}

根据实际项目修改 mainClass 和 projectName 参数。

运行与调试

通过命令行运行

在集成终端中导航到项目根目录，执行命令：

mvn spring-boot:run

使用 Spring Boot Dashboard

1. 点击侧边栏的 Spring Boot 图标打开仪表板
2. 找到目标项目
3. 点击播放按钮启动应用

调试模式运行

1. 在代码中设置断点（点击行号左侧）
2. 打开调试视图
3. 选择相应的调试配置
4. 点击开始调试按钮

高级功能

Spring Boot Actuator 集成

如果项目中包含 Spring Boot Actuator，可以通过访问相关端点（如 /actuator/health）监控应用状态。

任务自动化配置

创建 .vscode/tasks.json 文件来自动化构建过程：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Run Spring Boot",
      "type": "shell",
      "command": "mvn spring-boot:run",
      "group": "build",
      "problemMatcher": [],
      "detail": "Runs the Spring Boot application"
    }
  ]
}

通过任务面板或快捷键即可快速运行项目。

总结

通过上述步骤，可以在 VS Code 中高效地开发和调试 Spring Boot 应用程序。正确配置环境、安装必要扩展并合理利用调试功能，能够显著提升 Java 开发体验和效率。

提示：确保所有依赖正确加载，如遇问题可检查 Maven 配置和项目结构是否正确。