Eclipse 工作空间(Workspace)的默认 JDK 配置分为两个层面:一是 Eclipse IDE 自身启动运行的 JVM,二是新建 Java 项目时默认引用的编译/运行 JDK。通常用户所指的"默认 JDK"是后者。
一. 设置工作空间默认 JDK(影响所有新项目)此设置决定了新建项目时自动关联的 JRE 库。

-
打开 Window > Preferences (macOS 为 Eclipse > Preferences)。
-
展开 Java > Installed JREs。
-
点击右侧 Add... > 选择 Standard VM > Next。
-
在 JRE home 中点击 Directory...,选择 JDK 安装根目录(如 `C:\Program Files\Java\jdk-17` 或 `/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home`)。
-
点击 Finish 返回列表。
-
勾选 刚添加的 JDK 版本前的复选框,使其成为默认项。
-
点击 Apply and Close。
验证路径示例 (Windows)
C:\Program Files\Java\jdk-17.0.2
验证路径示例 (macOS)
/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home
```
二. 同步编译器合规级别
确保编译器版本与所选 JDK 一致,避免语法报错。
-
仍在 Preferences 窗口,展开 Java > Compiler。
-
将 Compiler compliance level 修改为与上述 JDK 一致的版本(如 17)。
-
点击 Apply and Close。
-
修改已有项目的 JDK(非全局默认)
若需单独调整某个已存在项目的 JDK,而非更改工作空间默认值:
-
右键项目 > Properties > Java Build Path > Libraries 选项卡。
-
选中 JRE System Library > 点击 Edit...。
-
选择 Alternate JRE,从下拉菜单中选择目标 JDK。
-
点击 Finish > Apply and Close。
-
关键注意事项
* 路径规范:JDK 安装路径及 Workspace 路径严禁包含中文、空格或特殊字符,否则可能导致构建失败或识别异常 。
* IDE 启动 JVM:若 Eclipse 启动失败或卡顿,需检查 `eclipse.ini` 文件。在 `-vmargs` 之前添加 `-vm` 参数指定 JDK 的 `javaw.exe` (Windows) 或 `java` (Mac/Linux) 绝对路径,这与项目编译用的 JDK 是独立的 。
* Maven 项目:若项目由 Maven 管理,`pom.xml` 中的 `maven-compiler-plugin` 配置优先级高于 Eclipse 界面设置,需同步修改 `pom.xml` 中的 `<source>` 和 `<target>` 版本 。