vscode需手动配置jdk与maven路径：通过“java: configure java runtime”添加jdk根目录（非bin/jre），设maven.executable.path指向mvn/mvn.cmd文件，右键pom.xml选“import to workspace”并执行“update project”方可启用完整java支持。
VSCode 不会自动识别你装好的 JDK 和 Maven，必须手动告诉它路径在哪里；否则即使 java -version 和 mvn -v 在终端里能跑，VSCode 依然报红、没提示、编译失败。
Java: Configure Java Runtime 比 java.home 更可靠
VSCode 的 Java 扩展优先读取“Java: Configure Java Runtime”里配置的 JDK 列表，而不是单纯依赖 java.home 或系统 JAVA_HOME。尤其在多 JDK 环境下，硬写 "java.home": "C:/.../jdk-17" 容易被覆盖或失效。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Java: Configure Java Runtime - 在 “JDKs” 标签页点击
+ Add JDK，直接浏览到 JDK 根目录（如C:\Program Files\Java\jdk-17.0.2或/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home），不要选bin子目录，也不要选jre - 确认后，状态栏右下角应显示类似
17或21的 JDK 版本号；若仍显示Not found，说明路径错或权限不足（macOS/Linux 注意ls -ld检查目录可读）
maven.executable.path 必须指向 mvn 或 mvn.cmd 文件本身
VSCode 的 Maven 插件默认尝试调用 mvn 命令，但不会自动从 PATH 查找——它需要明确的可执行文件路径。设成 MAVEN_HOME 目录或 bin 目录都会失败。
- 先在终端运行
which mvn（macOS/Linux）或where mvn（Windows），确认实际路径，例如：/opt/homebrew/bin/mvn、C:\apache-maven-3.9.6\bin\mvn.cmd - 打开 VSCode 设置（
Ctrl+,），搜索maven.executable.path，点击 “Edit in settings.json”，填入完整路径："maven.executable.path": "/opt/homebrew/bin/mvn" - 如果用 SDKMAN，路径通常是
~/.sdkman/candidates/maven/current/bin/mvn；Windows 用户注意用正斜杠或双反斜杠，避免转义问题 - 配完后重启 VSCode，再打开含
pom.xml的文件夹，左下角应出现Maven Projects面板，点刷新能看到模块和生命周期命令
导入 Maven 项目不是“打开文件夹”就完事
只把项目文件夹拖进 VSCode，pom.xml 不会被自动解析，IntelliSense 无法识别依赖类（比如 import org.springframework.web.bind.annotation.RestController 标红），但 mvn compile 命令行却可能成功——这是典型“VSCode 没导入，只当普通文本文件处理”的表现。
- 右键点击项目根目录下的
pom.xml文件，选择Import to Workspace（不是 “Open with” 或 “Run as Maven build”） - 观察状态栏右下角是否短暂显示
Building workspace，完成后应变成Java Projects: 1 project - 若弹出 “Project configuration is not up-to-date with pom.xml”，务必点通知里的
Update project，否则依赖版本、JDK 语言级别等配置不会同步 - 检查
.vscode/settings.json是否有残留的过时配置，比如"java.configuration.runtimes"里还写着"name": "JavaSE-1.8"，这会导致编译器用 JDK 8 解析，但运行时用 JDK 17，出错难排查
最常被跳过的其实是 pom.xml 导入动作和 Update project 确认——这两步不做，VSCode 就只是个高级文本编辑器，不是 Java IDE。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
