Mac电脑安装JDK 21并配置环境变量零基础教程

老丽大大_4120

老丽大大_4120

2026-08-14

545人浏览

原创

终端执行java -version报“command not found”,根本原因不是JDK未安装,而是shell未将JDK的bin目录加入PATH:需确保JAVA_HOME指向真实JDK路径(用/usr/libexec/java_home -v 21动态获取)、PATH包含$JAVA_HOME/bin且置于开头、配置写入~/.zshrc并执行source ~/.zshrc生效。

mac电脑安装jdk 21并配置环境变量零基础教程

为什么终端里敲 java -version 报 command not found?

不是 JDK 没装好,而是 shell 根本没找到 java 命令在哪。Mac 默认不把 JDK 的 bin 目录加进 PATH,就像你家钥匙没放门口——门锁没问题,只是你没拿到钥匙。

关键点有三个:JAVA_HOME 必须指向真实安装路径、PATH 必须包含 $JAVA_HOME/bin、配置文件必须被当前 shell 正确加载。三者缺一不可。

  • macOS Catalina(10.15)及之后默认用 zsh,配置文件是 ~/.zshrc,不是 ~/.bash_profile
  • JAVA_HOME 不能硬写死路径(比如 /Library/Java/.../jdk-21.jdk/Contents/Home),因为升级或重装后路径会变;要用 /usr/libexec/java_home -v 21 动态获取
  • export PATH=$JAVA_HOME/bin:$PATH 中 $JAVA_HOME/bin 必须放在 $PATH 前面,否则系统优先找到系统自带的旧版 java(如果有)

怎么确认 JDK 21 真的装好了?

别急着改配置文件。先验证安装本身是否成功:

  • 打开终端,运行 /usr/libexec/java_home -V,看输出里有没有类似 21.0.8, x86_64: "Java SE 21" /Library/Java/JavaVirtualMachines/jdk-21.0.8.jdk/Contents/Home 这样的条目
  • 如果没看到,说明安装失败或版本号不匹配——可能是下载了 ARM64 版却装在 Intel Mac 上,或反之
  • 如果看到了,复制那一行末尾的完整路径(从 /Library/... 开始),备用

注意:java -version 即使能返回结果,也不代表是你刚装的 JDK 21——可能只是系统残留的旧版本。所以一定要用 /usr/libexec/java_home -V 查全量已安装 JDK 列表。

怎么写对 ~/.zshrc 里的两行配置?

编辑 ~/.zshrc,只加这两行,别多别少:

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

常见错误:

ColossalChat
ColossalChat

ColossalChat是一款AI工具,Colossal-AI推出的免费开源版ChatGPT聊天机器人替代品。

下载
  • 漏掉 export 关键字,变量不会生效
  • 把 $JAVA_HOME/bin 写成 $JAVA_HOME/jre/bin(JDK 21 不再带独立 jre 目录)
  • 用了中文标点或全角空格,导致语法错误
  • 保存后没运行 source ~/.zshrc,配置只是“写好了”,没“活过来”

改完记得执行 source ~/.zshrc,然后立刻验证:echo $JAVA_HOME 应该输出路径,which java 应该返回 $JAVA_HOME/bin/java,java -version 和 javac -version 都得显示 21.x.x。

Homebrew 安装 vs 手动安装,选哪个?

如果你只是开发用,推荐 Homebrew 方式,省心且可复现:

  • brew install openjdk@21 后,/usr/libexec/java_home -v 21 仍能正确返回路径,和 Oracle 官方 JDK 行为一致
  • Homebrew 安装的 JDK 默认在 /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk(Apple Silicon)或 /usr/local/opt/openjdk@21/libexec/openjdk.jdk(Intel),但你不用管——/usr/libexec/java_home 会自动适配
  • 手动安装(.dmg)适合需要 Oracle 官方支持、或必须用特定构建(如含 JavaFX 的版本)的场景

无论哪种方式,配置逻辑完全一样:靠 /usr/libexec/java_home -v 21 获取路径,靠 export JAVA_HOME=... 和 export PATH=... 注入环境。路径来源不同,但注入方式不变。

最容易被忽略的是:每次新开终端窗口或标签页,都得确保 ~/.zshrc 被重新读取——如果某次忘了 source,或者误改了其他配置文件(比如 ~/.zprofile),就会回到“找不到命令”的状态。别怀疑 JDK,先 echo $JAVA_HOME 看一眼。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

环境变量

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12917

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9982

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

8472

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1344

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1068

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1616

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3369

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20611

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1475

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Postman环境变量管理手册
Postman环境变量管理手册

共0课时 | 0人学习

Starlette官方配置指南
Starlette官方配置指南

共0课时 | 0人学习

Gradle 安装与环境配置指南
Gradle 安装与环境配置指南

共0课时 | 0人学习