如何在VSCode中简洁调试Gradle配置的Spring Boot项目

针对你的需求，以下是两种最简洁的配置方案，无需手动处理Gradle进程或额外调试连接操作：

方案一：直接启动主类调试（推荐） #

不需要额外配置tasks.json，仅修改.vscode/launch.json即可，完全替代./gradlew bootRun的启动逻辑：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "Debug Spring Boot (Dev)",
            "request": "launch",
            "mainClass": "com.yourpackage.YourApplication", // 替换为你的Spring Boot主类全限定名
            "projectName": "myproj",
            "vmArgs": "-Dspring.profiles.active=dev", // 对应JVM级别的profile配置
            "args": "--spring.profiles.active=dev", // 对应程序启动参数（二选一即可，根据习惯配置）
            "env": {
                "SPRING_PROFILE": "dev" // 对应Gradle启动参数中的-PspringProfile=dev，若Gradle脚本依赖此变量则保留
            }
        }
    ]
}

说明： #

• VSCode的Java Debug插件会自动处理项目classpath，直接启动Spring Boot主类，启动后立即进入调试模式
• vmArgs和args任选其一即可实现加载dev环境配置，若项目同时依赖两者可都保留
• env中的SPRING_PROFILE对应原启动命令的-PspringProfile=dev，如果Gradle构建脚本不需要这个参数可以删除

方案二：通过Gradle bootRun启动并自动attach调试 #

若项目必须依赖Gradle bootRun任务的特殊逻辑（比如自定义构建步骤），可采用此方案：

1. 配置.vscode/tasks.json：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "gradle bootRun dev",
            "type": "shell",
            "command": "./gradlew",
            "args": [
                "bootRun",
                "-PspringProfile=dev",
                "--args='--spring.profiles.active=dev'",
                "--debug-jvm"
            ],
            "problemMatcher": [],
            "isBackground": true, // 标记为后台任务，避免VSCode等待进程结束
            "presentation": {
                "reveal": "never" // 不自动打开终端窗口，保持整洁
            }
        }
    ]
}

2. 配置.vscode/launch.json：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "Attach to Spring Boot Dev",
            "request": "attach",
            "hostName": "localhost",
            "port": 5005, // --debug-jvm默认调试端口为5005
            "preLaunchTask": "gradle bootRun dev" // 启动调试前自动执行Gradle任务
        }
    ]
}

说明： #

• --debug-jvm会让Gradle启动Spring Boot时开启调试端口并暂停，等待调试器连接
• isBackground: true确保VSCode不会因Gradle进程持续运行而卡住，自动进入attach调试流程

内容的提问来源于stack exchange，提问作者Emile D.