Mac 已装 Java 25 但还是旧版本？2026 新手修复指南

“安装位置”像书柜，“默认版本”像桌面上正在使用的那本教材。书柜里有 Java 25，不代表终端现在真的拿它运行。

第一步不要修改配置，先打开终端，依次执行：

java -version
javac -version
which java
which javac
/usr/libexec/java_home -V

每一条命令都要看清楚结果：

macOS 的 JDK 通常安装在 /Library/Java/JavaVirtualMachines/ 下，而真正的 JDK 主目录位于 .jdk/Contents/Home。官方目录说明也把 bin 目录列为命令行工具所在位置。(Oracle JDK 25 macOS 安装文档)

⚠️ 不要因为 /usr/bin/java 出现在结果里，就直接删除它或修改受保护的系统目录。官方安装说明明确提醒，不应通过移除 /usr/bin 中的 Java 工具来卸载 Java；系统更新还可能恢复这些内容。(Oracle JDK 25 macOS 安装文档)

看到 Java 25 列表，但默认版本仍是旧版

如果 /usr/libexec/java_home -V 能列出 Java 25，而 java -version 仍显示旧版，问题已经定位：安装基本完成，但默认选择没有切换。

先用一次性命令验证 Java 25 是否能正常工作：

/usr/libexec/java_home -v 25 --exec java -version
/usr/libexec/java_home -v 25 --exec javac -version

两条命令都输出 25，说明 Java 25 本身可以运行，暂时不要重装。macOS 官方文档提供了通过 java_home 选择指定版本并执行 java 或 javac 的方法。(Oracle JDK 25 安装与版本选择说明)

停止条件：

• 如果两条命令都显示 25：进入 JAVA_HOME 与 PATH 配置。
• 如果 java 显示 25，但 javac 失败：进入下一节检查 JDK 完整性。
• 如果 java_home -v 25 也找不到版本：检查安装包和处理器架构。

Java 学习不能只验证运行。java 用来启动程序，javac 用来把 .java 源代码编译成可运行的类文件。只会运行 java，不代表你已经有能写课程作业的完整开发环境。

可以把它理解成：你有一间能播放电影的教室，但没有剪辑和制作电影的设备。运行环境能打开已有程序，完整 JDK 才包含编译 Java 代码所需的工具。入门资料也明确区分了只用于运行的环境与包含编译器的 JDK。(Java 入门与 JDK 基础资料)

先执行：

/usr/libexec/java_home -v 25

如果返回类似下面的目录：

/Library/Java/JavaVirtualMachines/jdk-25.jdk/Contents/Home

再直接检查编译器：

"$(/usr/libexec/java_home -v 25)/bin/javac" -version

如果你下载的是只提供运行能力的环境，重新获取完整 JDK 安装包。下载时还要核对处理器架构：Apple Silicon 使用 AArch64，Intel Mac 使用 x64。官方 JDK 25 安装说明同时列出了这两类 macOS 安装包。(Oracle JDK 25 macOS 架构与安装包说明)

JAVA_HOME 可以理解成课程选课表上的“指定教室”。你不写清楚教室，系统就可能按照 PATH 或默认规则，把你带到旧版本所在的房间。

先只在当前终端窗口测试：

export JAVA_HOME=$(/usr/libexec/java_home -v 25)
export PATH="$JAVA_HOME/bin:$PATH"

echo "$JAVA_HOME"
java -version
javac -version
which java
which javac

预期结果是：

• echo "$JAVA_HOME" 指向 Java 25 的 Contents/Home；
• java -version 输出主版本 25；
• javac -version 输出 25；
• which java 和 which javac 都优先指向 $JAVA_HOME/bin 下的工具。

入门资料同样强调，JAVA_HOME 应指向 JDK 目录，PATH 则需要包含该 JDK 的 bin 目录；只在当前命令窗口设置，关闭窗口后不会自动保留。(Java 环境变量设置说明)

当前窗口有效，重新打开终端又失效

这是配置没有写入 shell 启动文件，或者写入了错误文件。先查看你正在使用的 shell：

echo "$SHELL"

如果结果以 zsh 结尾，可以编辑：

nano ~/.zshrc

加入：

export JAVA_HOME=$(/usr/libexec/java_home -v 25)
export PATH="$JAVA_HOME/bin:$PATH"

保存后执行：

source ~/.zshrc
java -version
javac -version

如果你的终端使用的是其他 shell，不要盲目照抄 ~/.zshrc。应把设置放进该 shell 实际读取的配置文件。你可以先用当前窗口的 export 测试成功，再决定是否持久化。

配置文件里有多行 JAVA_HOME

重复设置是新手最常遇到的隐性问题之一。例如前面写的是 Java 17，后面又写 Java 25，或者 PATH 中多次加入不同 JDK 的 bin 目录。最终生效的往往是靠后的设置，但不同启动方式可能读取顺序不同。

先备份，再搜索：

cp ~/.zshrc ~/.zshrc.backup
grep -nE 'JAVA_HOME|java_home|/JavaVirtualMachines|PATH=.*bin' ~/.zshrc

保留一组明确指向 Java 25 的设置，删除或注释旧设置。恢复原状时执行：

mv ~/.zshrc.backup ~/.zshrc

不要复制来源不明的“自动修复脚本”。环境变量只有几行，脚本却可能修改你不了解的文件和权限。

安装包选错架构，不一定每次都会立刻弹出明显错误。有时表现为无法安装，有时表现为工具启动异常，后续还可能在某些开发工具中出现兼容问题。因此，先识别设备，再核对文件名。

uname -m

Apple Silicon 不等于“名字里有 Mac 就能安装 ARM 包”。如果你使用的是远程 Mac，也不要只看设备昵称猜测架构。应从交付信息、系统设置中的“关于本机”，或连接后执行 uname -m 来确认。

官方安装页面说明，JDK 25 的 macOS 安装包分别使用 x64 和 aarch64 标识；安装目录则采用 .jdk/Contents/Home 结构。(Oracle JDK 25 下载与目录结构说明)

停止条件：

• 架构与安装包一致，且 java_home -V 能看到 Java 25：不必重新下载安装。
• 架构不一致但安装已失败：换正确安装包。
• 学校电脑禁止安装或要求管理员批准：不要绕过权限，改用获得授权的独立 Mac 环境。

终端、IDE 自身运行环境和项目 JDK 可能是三套设置。终端显示 Java 25，只能证明终端调用正确；它不能自动证明项目、模块或构建任务也使用 Java 25。

以常见的 Java IDE 为例，你需要分别检查：

1. 全局 SDK 列表中是否已经添加 Java 25；
2. 当前项目的 Project SDK 是否为 Java 25；
3. 当前模块是否继承项目 SDK；
4. 项目语言级别是否与你的课程要求一致；
5. IDE 内置终端是否在修改设置后重新打开。

IDE 官方文档把全局 SDK、项目 SDK 和模块 SDK 分开管理；项目可以选择一个 JDK，模块也可以单独覆盖它。(IDE SDK 与项目设置说明)

不要把“语言级别”误认为“JDK 路径”。语言级别像课堂允许使用的语法范围，项目 SDK 才是实际拿来编译的 JDK。IDE 甚至可能使用较新的 JDK，但仍把语言级别设为较旧版本，以保证课程代码兼容。(IDE 项目与模块设置说明)

用同一个最小文件做终端与 IDE 对照

在一个新文件夹中创建 HelloJava.java：

public class HelloJava {
    public static void main(String[] args) {
        System.out.println(System.getProperty("java.version"));
        System.out.println(System.getProperty("java.home"));
    }
}

在终端运行：

javac HelloJava.java
java HelloJava

再把同一个文件放入 IDE 项目中运行。比较两次输出：

修改项目 JDK 后，关闭并重新打开 IDE 内置终端。部分 IDE 会把项目 JDK 注入新终端会话，但已经打开的 shell 不会被追溯修改。(IDE 终端设置说明)

修复完成后，按下面的顺序验收。每一项都通过，才算环境真正可用。

• [ ] java -version 显示 Java 25；
• [ ] javac -version 显示 Java 25；
• [ ] which java 与 which javac 指向预期 JDK；
• [ ] java_home -V 能识别 Java 25；
• [ ] 最小 Java 文件可以编译；
• [ ] 最小 Java 文件可以运行；
• [ ] 关闭并重新打开终端后，版本仍然正确；
• [ ] IDE 项目 SDK、模块 SDK 和编译器没有继续指向旧版本；
• [ ] 项目文件保存在你有权限访问的位置；
• [ ] 重新登录远程 Mac 后，代码和配置仍然存在。

这里的“编译”和“运行”必须分开验证。入门流程的基本循环就是：先写源代码，再用编译器生成可执行的类文件，最后运行程序。

按条件决定：继续修复、建立独立环境，还是换设备

• 若 java_home -v 25 能找到 Java 25，且当前用户能修改 shell 配置：继续修复 JAVA_HOME 和 PATH。
• 若终端已正确，但 IDE 输出旧路径：只调整项目 SDK、模块 SDK 和 IDE 终端，不要重新安装 JDK。
• 若学校设备没有管理员权限，安装被策略拦截：停止尝试绕过限制，向管理员申请，或改用获得授权的干净 Mac。
• 若本机配置文件已有多套旧环境，且课程马上开始：先在独立环境中跑通项目，再回头整理本机。
• 若你只需要短期完成 Java 课程或测试项目：可以先使用远程 Mac，完成版本、编译、运行和文件保存验收。
• 若你需要长期高强度使用，或必须连接本地硬件、特殊外设：租赁环境未必合适，应评估自有设备或学校提供的实验室。

如果你是通过远程 Mac 学习，建议先阅读 Windows 连接远程 Mac 学编程 了解连接方式，再结合 远程 Mac 开发环境验收清单 检查代码保存、重新登录和终端状态。需要比较按需使用与长期设备成本时，可以查看 Mac 远程租赁方案说明。

学校电脑的主要问题通常不是性能，而是没有安装权限、配置会被还原、项目文件不能长期保留。远程 Mac 也有网络延迟、连接中断和文件同步需要确认等成本；它更适合临时学习、课程作业和环境验证，不一定适合所有长期重度开发。

如果你只是想先把 Java 25 课程项目跑通，CALMVPS 提供的是一台可远程访问的真实 Mac。你可以先按本文清单验证 java、javac、IDE 和重新登录后的环境是否一致，再决定是否继续整理自己的电脑；这比在受限学校设备上反复重装，更容易判断问题究竟来自 JDK 还是设备权限。