VSCode需通过扩展和配置才能运行Spring Boot项目——必须安装Java扩展包和Spring Boot扩展包，确保Maven编译成功，并用launch.json配置mainClass、args、env等参数，否则将出现类找不到、端口占用或配置不生效等问题。
VSCode 本身不内置 Spring Boot 运行支持，必须通过扩展和正确配置才能启动带参数的项目——直接点击“运行”按钮默认会失败，因为 SpringBootApp 类不是普通 Java 主类，它依赖 spring-boot-maven-plugin 或显式 classpath 构建环境。
安装并启用必需的 VSCode 扩展
没有这些扩展，VSCode 无法识别 SpringBootApplication 注解、无法解析 application.properties、也无法注入启动参数：
- 必装：
Extension Pack for Java（含 Language Support for Java、Debugger for Java、Project Manager for Java） - 强推：
Spring Boot Extension Pack（提供Spring Boot Dashboard、Spring Boot Tools，支持右键“Run Spring Boot App”） - 可选但实用：
Code Runner不适用 Spring Boot，禁用它对主类的默认运行，避免误触发编译报错
确保 Maven 构建成功后再运行
VSCode 的 Spring Boot 启动本质是调用 mvn spring-boot:run 或启动已编译的 target/classes。如果 mvn compile 失败，任何“运行”操作都会卡在 ClassNotFoundException 或 NoClassDefFoundError：
- 终端中执行
mvn clean compile，确认无红字报错 - 检查
pom.xml是否有spring-boot-starter-parent且版本与 JDK 匹配（如 Spring Boot 3.x 要求 JDK 17+） - 若用 Lombok，确认
lombok.config存在且@Data等注解被正确处理（否则mvn compile可能静默失败）
通过 launch.json 配置启动参数（最可靠方式）
图形化右键“Run”虽快，但传参能力弱；launch.json 支持完整 JVM 参数、程序参数、环境变量，且可复用：
在项目根目录创建 .vscode/launch.json，内容如下：
{
"version": "0.2.0",
"configurations": [
{
"type": "java",
"name": "Launch Spring Boot (with args)",
"request": "launch",
"mainClass": "com.example.demo.DemoApplication",
"projectName": "demo",
"args": ["--server.port=8081", "--spring.profiles.active=dev"],
"env": {
"JAVA_HOME": "/usr/lib/jvm/java-17-openjdk",
"SPRING_CONFIG_LOCATION": "file:./config/"
}
}
]
}
-
mainClass必须指向含@SpringBootApplication的类，不能写错包名 -
args是程序参数（即--xxx），不是 JVM 参数；JVM 参数需改用vmArgs字段（如"vmArgs": "-Xmx512m -XX:+UseG1GC"） -
env中路径尽量用绝对路径或相对于工作目录（cwd字段可指定） - 修改后按
Ctrl+Shift+D切换到运行视图，选择该配置再点 ▶️
常见启动失败原因和对应检查点
90% 的“运行不了”问题集中在三处：
-
Could not find or load main class：检查mainClass拼写、是否已mvn compile、target/classes下是否存在对应.class文件 -
Port 8080 is already in use：不是代码问题，而是上一次进程没退出；在终端执行lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows）杀掉残留进程 - 配置文件不生效（如
application-dev.yml未加载）：确认--spring.profiles.active=dev写在args里，而非vmArgs；同时检查resources目录是否被 VSCode 正确标记为 source folder（右键 → “Mark Directory as” → “Sources Root”）
Spring Boot 启动参数的灵活性全靠 launch.json 的细粒度控制，图形界面按钮只是快捷入口；一旦涉及多环境、外部配置挂载或调试断点，绕不开手动配这个文件。
