如何在VSCode中配置Spring Boot + Kotlin + Gradle项目

前置条件确认 #

你已经确认本地 VSCode 的 Java + Spring Boot + Gradle 环境运行正常，仅需补充 Kotlin 相关配置即可，无需从零搭建基础 Java 环境。

核心配置步骤 #

• 第一步：安装必要 VSCode 扩展
  确保你已经安装并启用以下官方扩展：
  • Extension Pack for Java（微软官方 Java 扩展包，你原有环境大概率已安装）
  • Spring Boot Extension Pack（VMware 官方 Spring 扩展包，原有环境已具备）
  • Kotlin Language（JetBrains 官方 Kotlin 语言支持扩展）
  • Kotlin Debug Adapter（Kotlin 调试支持扩展）
• 第二步：初始化项目骨架
  直接通过 VSCode 内置 Spring Initializr 入口生成项目即可，按Ctrl+Shift+P调出命令面板，输入Spring Initializr: Create a New Gradle Project，按提示选择以下配置项：
  • 语言选Kotlin
  • Gradle 脚本语言可选Kotlin DSL或Groovy DSL，按个人使用习惯选择即可
  • Spring Boot 版本选择稳定正式版即可
  • 按需勾选你需要的 Starter 依赖
• 第三步：配置校验与同步
  项目生成后打开根目录的build.gradle.kts（Kotlin DSL 场景）或build.gradle（Groovy DSL 场景），确认核心插件配置完整：

  // Kotlin DSL 示例配置
  plugins {
      id("org.springframework.boot") version "你选择的Spring Boot版本号"
      id("io.spring.dependency-management") version "对应依赖管理插件版本号"
      kotlin("jvm") version "你选择的Kotlin版本号"
      kotlin("plugin.spring") version "你选择的Kotlin版本号"
  }
  

  首次打开项目时 VSCode 会自动触发 Gradle 同步，等待同步完成即可。
• 第四步：功能验证
  新建一个带@RestController的测试接口，按Ctrl+Shift+P调出命令面板输入Spring Boot: Run Spring Boot App启动项目，调用测试接口确认返回正常，设置断点验证调试功能可用即配置完成。

常见问题排查 #

如果遇到 Gradle 同步失败的情况，可以按以下步骤排查：

• 国内用户建议先配置 Gradle 国内镜像源，避免依赖拉取超时导致同步失败
• 检查 VSCode 设置中kotlin.compiler.jvm.target参数和你项目的 Java 版本一致
• 先在命令行执行./gradlew clean build（Windows 系统执行gradlew.bat clean build），确认命令行可正常构建项目后再回到 VSCode 操作

内容的提问来源于stack exchange，提问作者feeecatz