vs code运行java必须手动配置jdk路径、插件和运行时：通过“java: configure java runtime”添加jdk根目录（非bin/jre），设maven.executable.path指向mvn/mvn.cmd，右键pom.xml选“import to workspace”并执行“update project”。
VS Code 能跑 Java，但必须手动配齐 JDK + 插件 + 运行时路径，缺一不可；自动识别经常失效，尤其多 JDK 共存时，java.home 和 java.configuration.runtimes 必须分清用途、分别配置。
Java -version 能运行 ≠ VS Code 能用 Java
终端里 java -version 和 javac -version 有输出，只说明系统级 JDK 环境变量（JAVA_HOME + PATH）配对了。VS Code 的 Java 插件默认不读这些变量，它靠自己的配置项启动语言服务器和编译器。
常见错误现象：
- 新建
.java文件后无语法高亮、无补全、按 F5 报错 “No Java runtime configured” - 右下角弹出 “The project uses Java 17, but no compatible JDK is configured”，点“Configure”后仍无效
- 明明装了 JDK 21，插件却坚持用自带的 JRE 启动语言服务器，导致新语法（如 record、pattern matching）标红
关键区别：
-
java.home：指定插件启动 Java Language Server 所用的 JDK（要求 ≥ JDK 21） -
java.configuration.runtimes：指定项目编译/运行时实际用的 JDK（可含 JDK 8/11/17/22 等多个版本）
Extension Pack for Java 必装，但别全信“一键安装”
微软官方的 Extension Pack for Java 是起点，但它内部包含 6 个子插件，部分行为需单独干预：
-
Language Support for Java™ by Red Hat：提供补全和诊断，但若java.home指向旧 JDK（如 JDK 11），它会拒绝加载，直接静默失败 -
Debugger for Java：调试依赖java.configuration.runtimes中匹配的 JDK，若 runtime 名称写成"JavaSE-17"，而pom.xml里写的是17，可能断点不生效 -
Maven for Java：识别pom.xml后自动下载依赖，但首次加载卡在 “Resolving dependencies…” 时，不是插件坏了，是 Maven 镜像没配，得手动设maven.settings.file
实操建议：
- 装完插件后，务必重启 VS Code（不是重载窗口），否则新配置不生效
- 打开空文件夹 →
Ctrl+Shift+P→ 输入Java: Configure Java Runtime，再点 “Add JDK”，比直接改settings.json更可靠（它会自动校验路径并生成合法 JSON） - 如果用 Maven，顺手搜
maven.executable.path，填入本地mvn或mvn.cmd绝对路径，避免插件调用系统 PATH 里的旧版 Maven
多 JDK 共存时，runtime 名称必须严格匹配规范
java.configuration.runtimes 不是随便起名的。名称必须符合 Eclipse JDT 的标准标识，否则 Maven/Gradle 构建或测试运行时会 fallback 到默认 JDK，导致 UnsupportedClassVersionError 或 ClassNotFoundException。
一款AI工具，主要用于通过后台进程运行 Codex CLI、Claude Code、OpenCode 或 Pi Coding Agent，实现程序化控制，适合需要提升相关任务效率的用户。
正确写法示例（Windows）：
"java.configuration.runtimes": [
{
"name": "JavaSE-17",
"path": "C:\Program Files\Eclipse Adoptium\jdk-17.0.9.9-hotspot"
},
{
"name": "JavaSE-22",
"path": "C:\Program Files\Eclipse Adoptium\jdk-22.0.1.8-hotspot",
"default": true
}
]
容易踩的坑：
- 写成
"name": "jdk-17"或"name": "17"→ 不识别，构建用错 JDK - 路径末尾带
\bin（如C:\...\jdk-17\bin）→ 插件报错 “JDK root not found” - Mac/Linux 用户用
~表示家目录（如~/jdk-17）→ 不支持，必须写绝对路径 - 同时配置了
java.home和java.configuration.runtimes，但前者指向 JDK 11，后者含 JDK 22 → 语言服务器启动失败，整个 Java 功能瘫痪
首次打开 Maven 项目，别跳过右下角那个提示
用 VS Code 直接打开含 pom.xml 的文件夹后，右下角会弹出 “Load project” 按钮。这不是可选项，是强制流程入口。
不点它的后果：
-
src/main/java不被识别为源码根目录，类名标红，import无法解析 - Maven 依赖不加载，
mvn compile命令面板里找不到，右键pom.xml无 “Run as Maven build” 选项 - JUnit 测试类不显示绿色三角形，
Test Runner for Java完全失能
实操要点：
- 弹出提示后立刻点 “Load project”，等待状态栏出现 “Java Projects: Loading…” 并最终消失
- 若卡住超过 2 分钟，检查
maven.settings.file是否指向了正确的settings.xml（尤其国内用户需配阿里云镜像） - 加载完成后，按
Ctrl+Shift+P输入Java: Show Java Home，确认当前项目绑定的 runtime 名称与java.configuration.runtimes中定义的一致
最常被忽略的细节：JDK 21+ 的语言服务器必须用 java.home 单独指定，而项目本身可以继续用 JDK 17 编译——这两个路径可以不同，但不能混淆用途；一旦写反，整个编辑体验就退化成纯文本编辑器。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
