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 用户注意用正斜杠或双反斜杠，避免转义问题
右键 pom.xml → Import to Workspace 才算真正导入
只把项目文件夹拖进 VSCode，pom.xml 不会被自动解析，IntelliSense 无法识别依赖类（比如 import org.springframework.web.bind.annotation.RestController 标红），但 mvn compile 命令行却可能成功——这是典型“VSCode 没导入，只当普通文本文件处理”的表现。
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
- 右键点击项目根目录下的
pom.xml文件，选择Import to Workspace（不是 “Open with” 或 “Run as Maven build”） - 观察状态栏右下角是否出现
Building workspace，完成后应显示Java Projects: X projects - 若提示 “Project configuration is not up-to-date with pom.xml”，点通知里的
Update project
IntelliSense 不提示依赖类？先检查 settings.xml 是否加载
Maven 插件默认只读取全局 settings.xml，但多数人把私有仓库、镜像或认证信息写在用户级 ~/.m2/settings.xml 里，VSCode 却没加载它。
- 打开 VSCode 命令面板，运行
Maven: Change Settings，选择你实际使用的settings.xml文件（通常是~/.m2/settings.xml） - 检查
settings.xml里C:\Program Files\这类系统保护目录，Maven 会静默失败 - 若公司使用私有 Nexus/Artifactory，确认
id与mirrorOf匹配，且~/.m2/settings.xml权限允许 VSCode 读取（macOS/Linux 注意chmod 600）
最常被忽略的是：路径末尾不能加 /bin，JDK 和 Maven 都必须指向根目录；还有就是 Import to Workspace 这一步，很多人以为打开文件夹就等于导入项目，结果卡在依赖标红上很久。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
