VS Code需手动配置JDK 17+路径并安装Java/Spring Boot扩展，否则无法识别语法或启动应用；必须设置java.home、重启编辑器、验证环境变量及Maven导入，调试前确保DevTools启用且端口未冲突。
VS Code 本身不内置 Java 运行时或 Spring Boot 支持，必须手动配置 JDK 路径并安装对应扩展，否则 java 命令能运行、但编辑器无法识别语法、无法启动 Spring Boot 应用。
确认系统已安装 JDK 17+ 并正确配置 JAVA_HOME
VS Code 的 Java 扩展（如 Extension Pack for Java）依赖系统级 JDK，不是靠它自己下载。常见错误是只装了 JRE 或 JDK 8/11 但项目要求 JDK 17+（Spring Boot 3.x 强制要求）。
- 在终端运行
java -version和javac -version，确保输出一致且 ≥ 17 - 运行
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows），路径必须指向 JDK 根目录（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home），不能是jre子目录 - 如果使用 SDKMAN! 或 jEnv，确保当前 shell 中
java命令实际调用的是目标 JDK（which java+ls -l验证） - VS Code 启动方式会影响环境变量：从桌面图标或 Dock 启动可能读不到 shell 的
JAVA_HOME，建议从终端执行code命令启动
安装必要扩展并设置 java.home
仅装 “Java Extension Pack” 不够，VS Code 需要明确知道 JDK 在哪。扩展不会自动读取系统 JAVA_HOME，必须显式配置。
- 安装以下扩展（缺一不可）：
Extension Pack for Java、Spring Boot Extension Pack、Language Support for Java(TM) by Red Hat - 打开 VS Code 设置（
Cmd+,/Ctrl+,），搜索java.home，点击“Edit in settings.json”，填入绝对路径，例如："java.home": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"
- 重启 VS Code —— 不重启，扩展仍会报 “The JAVA_HOME environment variable is not defined correctly” 或无法解析
@SpringBootApplication - 检查状态栏右下角是否显示 JDK 版本号（如 “17”），点击可切换，但切换前提是该 JDK 已被
java.home或java.configuration.runtimes显式声明
初始化 Spring Boot 项目时避开 Maven 仓库和依赖解析陷阱
VS Code 内置的 Spring Boot 初始化（通过 Spring Boot Dashboard）本质是调用 start.spring.io API 下载 zip，但后续构建严重依赖本地 Maven 配置。
立即学习“Java免费学习笔记（深入）”；
- 首次打开项目后，务必等待右下角弹出 “Importing Maven project…” 完成，否则
@RestController等类标红、mvn spring-boot:run报ClassNotFoundException - 若卡在 “Resolving dependencies”，检查
~/.m2/settings.xml是否配置了私有镜像（如阿里云），或临时删掉该文件让 Maven 用默认中央仓库 - 不要手动修改
pom.xml后立即运行；先右键pom.xml→ “Reload project”，否则 VS Code 的语言服务器无法同步依赖变更 - 运行时选 “Spring Boot App” 类型而非纯 “Java Application”，否则不会加载
spring-boot-maven-plugin的内嵌容器逻辑
调试 Spring Boot 时注意端口冲突与热重载限制
VS Code 默认调试配置不启用 Spring DevTools，且断点可能因类加载机制失效。
- 在
pom.xml中确认已添加spring-boot-devtools依赖，否则修改代码后需手动重启 - 调试前检查
application.properties中server.port是否被占用，VS Code 调试器不会自动换端口 - 设断点后启动调试，若断点灰化（unverified breakpoint），大概率是源码未关联：检查
target/classes是否生成、spring-boot-maven-plugin的fork是否为true（默认是） - 避免在
@PostConstruct或静态块中设断点——这些在主类加载阶段执行，调试器尚未 attach
最常被跳过的一步：每次更换 JDK 版本或重装系统后，java.home 设置不会自动更新，且 VS Code 缓存的 classpath 可能残留旧版本依赖。遇到奇怪的编译错误或注解不识别，优先清空 .vscode 目录和 target 文件夹，再重新导入项目。
