VSCode 可胜任 Spring Boot 开发，关键在于 java.home、spring-boot-dashboard 和 Language Support for Java 三者对齐：需手动配置 JDK 路径、安装三大核心扩展、用离线方式初始化项目、正确设置 launch.json 与 application.yml 端口、启用 DevTools 并清理语言服务器缓存。
VSCode 本身不是 Java IDE，但通过正确配置扩展和工具链，完全可以胜任 Spring Boot 开发——关键不在“能不能”，而在「java.home、spring-boot-dashboard 和 Language Support for Java 三者是否对齐」。
确认 JDK 已安装且被 VSCode 识别
VSCode 不自带 JDK，必须手动指定路径。如果 java -version 在终端能正常输出，不代表 VSCode 能自动找到它。
- 在 VSCode 中按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Java: Configure Java Runtime，进入设置页 - 在
Java Runtime Configuration页面中，检查Default JRE是否指向你期望的 JDK（如/usr/lib/jvm/java-17-openjdk-amd64或C:\Program Files\Java\jdk-17.0.2） - 若为空或错误，点击
+ Add JDK，手动选择 JDK 根目录（不是bin子目录） - 重启 VSCode 后，打开一个
.java文件，看右下角状态栏是否显示 JDK 版本；若显示Java (unresolved)或报错The JAVA_HOME environment variable does not point to a valid JVM installation，说明路径未生效
安装并验证核心扩展组合
仅装 Extension Pack for Java 不够，Spring Boot 项目依赖额外支持。缺一不可：
-
Language Support for Java：提供基础语法校验、跳转、补全（由 Red Hat 维护） -
Debugger for Java：运行/调试 Java 类，必须启用java.debug.settings.launch.args才能传参给 Spring Boot -
Spring Boot Extension Pack：含Spring Boot Dashboard（可视化启动/停止）、Spring Boot Tools（@Autowired提示、application.properties高亮） - 禁用冲突扩展：如
Java Test Runner若与Test Explorer UI冲突，会导致测试图标不显示
初始化 Spring Boot 项目时绕过 Maven 卡死
VSCode 内置的 Spring Initializr（通过 Ctrl+Shift+P → Spring Initializr: Generate a Maven Project）本质是调用 start.spring.io API。国内用户常卡在 “Generating project…” 无响应。
立即学习“Java免费学习笔记（深入）”；
- 先确保网络可访问
https://start.spring.io；不行就改用离线方式：curl https://start.spring.io/starter.zip -o demo.zip下载后解压导入 - 导入项目后，首次加载会触发 Maven 下载依赖，VSCode 右下角出现
Downloading dependencies...—— 此时不要关窗口，否则.project元数据损坏，需删掉.vscode目录重来 - 若
pom.xml报红（如org.springframework.boot:spring-boot-starter-webunresolved），检查settings.json中是否误加了"maven.executable.path"指向旧版 Maven；建议留空，让插件用内置maven-wrapper
调试 Spring Boot 应用时注意端口与配置优先级
直接点右上角 ▶️ 运行 Application.java 往往失败，因为 Spring Boot 默认读取 application.properties 的 server.port，而 VSCode 调试器可能覆盖它。
- 在
.vscode/launch.json中，确保configurations包含"request": "launch"和"mainClass": "com.example.demo.DemoApplication" - 如需指定端口，不要写死在
launch.json的args里，而应在application.yml中设server.port: 8081，或通过env字段注入："env": {"SERVER_PORT": "8081"} - 修改
application.properties后，热更新不一定生效——Spring Boot DevTools 需要额外配置：spring.devtools.restart.enabled=true，且 VSCode 的文件保存必须触发编译（检查Java Build Path是否启用Build automatically）
最易忽略的是：VSCode 的 Java 插件会缓存项目结构，一旦 pom.xml 增加新依赖，必须手动执行 Java: Clean the Java language server workspace，否则新类无法 import、注解不识别。这不是 bug，是设计使然。
