在Eclipse中确认当前JDK版本需进入Preferences → Java → Installed JREs,带勾选标记的即为默认使用的JDK;若列表为空或显示Unknown/红色叹号,则未正确配置。
打开 Eclipse 后,Eclipse → Preferences(macOS)或 Window → Preferences(Windows/Linux),在左侧导航树展开 Java → Installed JREs。右侧列表显示所有已注册的 JRE/JDK,带勾选标记的是当前默认使用的 JDK。如果列表为空或版本不对,说明尚未正确配置。
常见错误现象:新建 Java 项目时提示 The project cannot be built until build path errors are resolved,或右键项目 → Properties → Java Build Path → Libraries 中 JRE System Library 显示 Unknown JRE 或红色叹号。
jdk-xx.x.x 目录(含 bin/java 和 jre/lib/rt.jar),而非仅 jre 子目录C:\Program Files\... 容易触发权限或解析异常)/opt/homebrew/opt/openjdk/libexec/openjdk.jdk(ARM)或 /usr/local/opt/openjdk/libexec/openjdk.jdk(Intel)在 Preferences → Java → Installed JREs 页面点击 Add...,选择 Standard VM → Next。关键步骤是点击 Directory... 并准确选中 JDK 根目录(例如 /Library/Java/JavaVirtualMachines/j 或
dk-17.0.1.jdk/Contents/HomeC:\Program Files\Java\jdk-21)。
添加后必须手动勾选该条目才能生效;否则新项目仍会沿用旧配置。Eclipse 不会自动将系统 JAVA_HOME 注册为可用 JRE。
Directory... 后弹出空白或报错,大概率是所选路径不包含 bin/javac(编译器)或 jre/lib/rt.jar(运行时类库)rt.jar,改用模块化结构,但 Eclipse 4.20+ 能识别;若使用老版本 Eclipse(如 4.13),建议搭配 JDK 11 或 15右键项目 → Properties → Java Build Path → Libraries,找到 JRE System Library,点击 Remove,再点 Add Library... → JRE System Library → Next,选择 Alternate JRE 并从下拉菜单中选取已注册的某个 JDK。
这个设置优先级高于全局 Installed JREs 默认值,但只影响当前项目。适用于多 JDK 混合开发场景(比如维护遗留 Java 8 项目的同时开发新 Java 21 模块)。
Refresh,并确保 Project → Build Automatically 已启用,否则错误不会实时更新pom.xml 中的 maven-compiler-plugin 配置,否则编译行为可能与 Eclipse 显示不一致.project 文件中的 和 .settings/org.eclipse.jdt.core.prefs 是否包含 org.eclipse.jdt.core.compiler.compliance=17 等字段,这些才是实际生效的编译级别Eclipse 自身是一个 Java 应用,其运行依赖于启动时的 JVM。若系统默认 JAVA_HOME 指向不兼容版本(如用 JDK 8 启动基于 Java 17 编译的 Eclipse 2025-09),会出现闪退或界面卡死。此时需修改 eclipse.ini 文件。
在 Eclipse 安装根目录下找到 eclipse.ini,在 -vmargs 行之前插入两行:
-vm /Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home/bin/java
注意:-vm 和路径必须分两行,且路径必须精确到 java 可执行文件(不是仅到 Home 目录);该配置对 Windows/macOS/Linux 均有效。
-vm 换行后写 C:\Program Files\Java\jdk-21\bin\javaw.exe(推荐用 javaw.exe 避免控制台窗口)eclipse.ini 后必须完全退出 Eclipse(包括系统托盘进程),再重新启动才生效eclipse.ini 未配导致 IDE 偶发卡顿或无法加载视图。