vs code切换openjdk多版本的关键是同时正确配置java.home（指向jdk根目录，非bin）和java.configuration.runtimes（声明标准命名的多版本列表），并重启窗口验证，避免ide缓存与语言服务器残留导致版本不一致。
VS Code 里切换 OpenJDK 多版本，关键不是“改全局环境变量”，而是让 java.home 和 java.configuration.runtimes 同时生效，并且避开 IDE 缓存和语言服务器残留状态。光改 JAVA_HOME 或只调命令面板，90% 的人会遇到“明明选了 JDK 17，javac --version 还是 8”这类问题。
VS Code 的 java.home 必须指向 JDK 根目录，不是 bin
这是最常踩的坑：把路径写成 C:\Program Files\Java\jdk-17.0.5\bin 或 /usr/lib/jvm/jdk-17/bin —— 这会导致 Java 扩展启动失败，报错 Cannot resolve Java runtime 或直接不加载语言服务。
-
java.home值必须是 JDK 安装根目录（即包含bin/、lib/、jre/的那一层），例如：C:\Program Files\Java\jdk-17.0.5或/usr/lib/jvm/jdk-17 - 路径中含空格或中文？Windows 上建议用短路径（如
C:\Java\jdk-17），macOS/Linux 上确保权限可读 - 修改后必须重启 VS Code 窗口（不是重载窗口），否则 Java 扩展不会重新读取
settings.json
项目级 settings.json 要配齐两个字段
只设 java.home 不够，VS Code 的 Java 语言服务器（JDT LS）可能仍用系统默认 JDK 编译校验。必须显式声明运行时列表，让编辑器知道“这个项目允许用哪些 JDK”。
- 在项目根目录下创建
.vscode/settings.json，内容至少包含： "java.home": "/path/to/jdk-17""java.configuration.runtimes": [ { "name": "JavaSE-17", "path": "/path/to/jdk-17" } ]- 如果项目还要支持 Java 8 编译（比如
maven-compiler-plugin设为1.8），就追加一个条目：{ "name": "JavaSE-1.8", "path": "/path/to/jdk-1.8" } - 注意：
name字段必须匹配标准命名（JavaSE-1.8、JavaSE-11、JavaSE-17等），大小写和连字符都不能错
命令面板切换只是快捷方式，背后还是改 settings.json
按 Ctrl+Shift+P → 输入 Java: Configure Java Runtime 确实方便，但它本质是自动写入或覆盖 .vscode/settings.json 中的 java.home 和 java.configuration.runtimes。如果你手动改过配置，又用命令面板切了一次，很可能把之前写的多版本 runtime 删掉了。
- 命令面板操作后，立刻打开
.vscode/settings.json检查内容是否完整 - 如果发现
java.configuration.runtimes被清空或只剩一项，说明扩展没识别到你本地安装的其他 JDK —— 此时要确认路径是否真实存在、是否有读取权限 - Mac/Linux 用户特别注意：JDK 路径如果是
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home，别漏掉末尾的/Home
OpenJDK 发行版路径差异容易导致识别失败
不同 OpenJDK 发行版的安装结构不统一，VS Code 可能扫描不到。比如 Eclipse Temurin 在 macOS 上路径是 /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home，而 Amazon Corretto 是 /usr/lib/jvm/java-17-amazon-corretto。硬编码路径出错率高，不如用工具管理。
- 推荐在终端先验证路径有效性：
ls -la /path/to/jdk-17/bin/javac和/path/to/jdk-17/lib/tools.jar（JDK 9+ 可能没有tools.jar，改查lib/jrt-fs.jar） - Linux/macOS 下优先用
sdk list java（SDKMAN!）或mise ls java（mise）确认已注册版本，再复制其输出的真实路径 - Windows 上若用 Scoop 安装，路径类似
C:\Users\XXX\scoop\apps\temurin17\current，注意current是软链接，VS Code 能识别，但某些插件可能要求绝对路径
真正麻烦的不是“怎么切”，而是“切完之后编译、调试、测试全用的不是同一个 JDK”。比如 Maven 构建用的是 mvn 自带的 JDK，而 VS Code 调试器用的是 java.home，两者不一致就会出现 “代码补全提示对，但运行时报 UnsupportedClassVersionError”。这时候得同步检查 pom.xml 的 maven-compiler-plugin 和 launch.json 的 vmArgs 里是否也约束了版本。
