VSCode配置Java开发环境及依赖管理-VSCode-PHP中文网

vscode报“jdk not found”主因是未正确识别jdk路径：需确保java_home指向jdk根目录（非bin/jre）、java -version与javac -version版本一致，并通过java: configure java runtime手动添加jdk路径后重启语言服务器。

vscode配置java开发环境及依赖管理

VSCode 本身不带 Java 运行时，装完 JDK 和插件后仍报 JDK not found 或 java.home 报红，不是 JDK 没装好，而是 VSCode 没读到你真正想用的那个 JDK 路径——尤其当你有多个 JDK 或从终端启动 VSCode 时环境变量不一致，问题会更隐蔽。

确认 JAVA_HOME 和终端输出是否一致

这是最常被跳过的验证步骤。VSCode 的 Java 扩展（redhat.java）依赖系统环境变量做初始探测，但又不完全信任它。

java -version 和 javac -version 必须输出**完全一致的版本号**，否则说明 JAVA_HOME 或 PATH 没生效
JAVA_HOME 必须指向 JDK 根目录，不是 bin、不是 jre，例如：/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home（macOS）、C:\Program Files\Eclipse Adoptium\jdk-17.0.2+8（Windows）
如果从终端启动 VSCode（比如执行 code .），终端的环境变量会继承过去；如果直接双击图标启动，它读的是系统级环境变量，二者可能不同

用 Java: Configure Java Runtime 手动添加 JDK

比硬改 settings.json 更可靠。VSCode 的 Java 扩展优先读取这个界面配置，而非仅依赖 java.home。

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并运行 Java: Configure Java Runtime
在 “JDKs” 标签页里点 Add JDK，直接选中你确认有效的 JDK 根目录（就是上面验证过的那个路径）
已有多个 JDK 时，勾选你希望项目默认使用的那个，并留意右下角是否出现 Java Language Server is running
如果之前在 settings.json 里写过 java.configuration.runtimes，且含已卸载的旧 JDK 路径，删掉它——这类残留会覆盖界面设置

右键 pom.xml → Import to Workspace 是关键动作

VSCode 不会自动把 pom.xml 当作项目入口。只新建文件、放个 pom.xml 是不够的，必须显式触发导入。

在资源管理器中右键 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（等效于刷新依赖和 classpath）
项目用了私有仓库？确保 ~/.m2/settings.xml 已被加载：用命令面板运行 Maven: Change Settings，手动指向它

mvn compile 成功但 VSCode 报红依赖？检查类路径来源

VSCode 的语言服务器不直接复用 mvn compile 的 classpath，它靠自己解析 pom.xml + 缓存 + 项目结构推导，容易卡在中间态。

先确认源码目录是否被识别为 src/main/java：右键该文件夹 → Mark Directory as → Sources Root
检查 .vscode/settings.json 是否误加了干扰项，比如错误的 java.compile.nullAnalysis.mode 或废弃的 java.silentConfigValidation
重启 Java Language Server：命令面板运行 Java: Restart Language Server，比重启 VSCode 更快见效
如果刚换过 JDK 版本，旧缓存可能残留，删掉项目根目录下的 .vscode 和 .project（如有），再重新 Import to Workspace