VSCode本身不生成Spring项目，仅识别和驱动已有Maven/Gradle项目；“快速生成”实为调用Spring Initializr服务创建骨架，再由插件解析构建配置，易因构建工具误判、环境变量未继承或JDK绑定失败而卡住。
VSCode 本身不生成 Spring 项目，它只负责识别和驱动已存在的 Maven 或 Gradle 项目；所谓“快速生成”，实际是调用 Spring Initializr 服务创建骨架，再由插件解析构建配置 —— 这个过程容易卡在构建工具误判、环境变量未继承、或插件未正确绑定 JDK 上。
为什么 VSCode 点“Create Java Project”后没反应或报错 Command 'Java: Create Java Project' not found
这不是插件没装全，而是 Extension Pack for Java 没完全激活或 Java 语言服务器（JDT LS）启动失败。常见触发条件：
- VSCode 是从 Dock 或桌面图标启动的，没继承 shell 的
JAVA_HOME和PATH—— 必须在终端执行code .打开项目目录 -
java.home设置错误，比如路径指向了 JRE 而非 JDK，或版本低于 17（Spring Boot 3.x 强制要求） - 项目根目录同时存在
pom.xml和build.gradle，插件无法自动选择构建工具，会静默跳过初始化
验证方式：打开 VSCode 内置终端，运行 java -version 和 mvn -v（或 gradle -v），任一命令报“command not found”，就说明环境变量没透传进来。
创建完项目后右键 Run 主类失败，提示 Could not find or load main class
VSCode 的 Java 插件默认不直接运行源码，而是依赖编译输出（target/classes 或 build/classes）。如果没编译过，或者构建工具被绕过，就会找不到类。
- 手动触发一次构建：
mvn compile（Maven）或./gradlew classes（Gradle），再右键运行 - 检查主类是否在
src/main/java下，且包名路径与文件系统路径严格一致（比如com.example.demo.DemoApplication必须放在src/main/java/com/example/demo/DemoApplication.java） - 确认
pom.xml中spring-boot-maven-plugin已声明，或build.gradle中已启用org.springframework.boot插件 —— 否则插件无法识别为 Spring Boot 项目
想切 Maven 和 Gradle，但 VSCode 总认错成另一个
插件判断依据非常朴素：看项目根目录是否存在 pom.xml 或 build.gradle，**谁先被扫描到、谁就赢**。没有“优先级设置”，只有文件存在性竞争。
- 如果想用 Maven 但项目里残留了
build.gradle，哪怕只是空文件，也得删掉，否则插件大概率走 Gradle 流程 - 首次打开项目时，设置
java.configuration.updateBuildConfiguration为interactive，会弹窗让你手动选 Maven 还是 Gradle - 已误判后想切换？关掉所有 VSCode 窗口 → 删除项目下
.vscode/目录 → 重新用code .打开 → 弹窗出现时立刻选对构建工具
热更新（DevTools）不生效，改完代码还得重启
Spring Boot DevTools 在 VSCode 里不是开箱即用的，它依赖三个独立开关同时打开：
- 项目
pom.xml中必须有spring-boot-devtools依赖（runtime - VSCode 设置中开启自动编译：
java.autobuild.enabled设为true - 启动时 JVM 参数必须包含
-Dspring.devtools.restart.enabled=true—— 右键主类 → “Run Configurations” → 在VM Options里手动加
缺任意一个，修改 Java 文件后都不会触发 restart，只会默默编译进 target/classes 却不通知 Spring 容器。
最常被忽略的是 JVM 参数那一项：VSCode 默认不带任何参数启动，即使 DevTools 依赖和自动编译都开了，没加这个参数，热更就等于没装引擎。
