Java JDK 21 安装与环境配置指南（Windows/macOS）

分步安装 JDK 21

1. 双击下载的 exe 安装包，弹出安装向导，点击'下一步'。
2. 选择安装目录（建议默认路径，如 D:\App\JDK\jdk-21，便于后续配置；若需自定义路径，需记住安装位置，避免中文路径）。
3. 勾选'开发工具'（必须勾选，包含 javac 编译器、java 运行器等核心工具），其他组件默认即可，点击'下一步'。
4. 等待安装进度条完成（约 1-2 分钟），点击'关闭'，安装完成。

环境变量配置（关键步骤）

环境变量的作用是让 Windows 系统在任意目录下识别 Java 命令（如 javac、java）。配置步骤如下：

打开环境变量配置窗口

• 方法 1：右键'此电脑'→'属性'→'高级系统设置'→'环境变量'。
• 方法 2：按下 Win+R，输入 sysdm.cpl，回车→切换到'高级'选项卡→'环境变量'。

配置系统变量（3 个核心变量）

① 新建'JAVA_HOME'变量

• 在'系统变量'区域点击'新建'。
• 变量名：JAVA_HOME（大写，固定写法）。
• 变量值：JDK 的安装目录（如默认路径 C:\Program Files\Java\jdk-21，需与实际安装路径一致）。
• 点击'确定'保存。

② 配置'Path'变量

• 在'系统变量'中找到'Path'，双击打开编辑窗口。
• 点击'新建'，输入 %JAVA_HOME%\bin（引用 JAVA_HOME 变量，避免后续修改路径重复配置）。
• （可选）再点击'新建'，输入 %JAVA_HOME%\jre\bin（JRE 运行环境路径，部分版本需手动添加）。
• 点击'上移'，将两个新建的路径移到顶部，避免与其他环境变量冲突，点击'确定'。

③ （可选）新建'CLASSPATH'变量

• 在'系统变量'区域点击'新建'。
• 变量名：CLASSPATH。
• 变量值：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar（注意开头的英文句号，代表当前目录）。
• 点击'确定'保存。

保存所有配置

依次点击环境变量窗口和系统属性窗口的'确定'，确保配置生效。

安装与配置验证

1. 按下 Win+R，输入 cmd，打开命令提示符（CMD）。
2. 依次输入以下 3 条命令，若均显示正常信息，则说明安装配置成功：
   • 查看 JDK 版本：java -version（显示'java version "21.0.x"'等信息）。
   • 查看编译器版本：javac -version（显示'javac 21.0.x'等信息）。

macOS 系统：JDK 安装与配置

分步安装 JDK 21

1. 双击下载的 dmg 安装包，弹出挂载窗口，双击里面的'JDK 21.pkg'安装程序。
2. 弹出安装向导，点击'继续'→'同意'许可协议→选择安装位置（默认即可）→输入电脑开机密码，点击'安装'。
3. 等待安装完成（约 1 分钟），点击'关闭'，安装包可拖拽到废纸篓删除。

环境变量配置（分终端类型）

macOS 默认使用 zsh 终端（macOS 10.15 及以上），部分老版本使用 bash 终端，需根据终端类型配置：

查看终端类型

打开'终端'（启动台→其他→终端），输入 echo $SHELL：

• 输出 /bin/zsh：zsh 终端（主流）。
• 输出 /bin/bash：bash 终端。

配置环境变量

① zsh 终端（推荐）

1. 终端输入命令，编辑 zsh 配置文件：open ~/.zshrc（若文件不存在，先创建：touch ~/.zshrc）。
2. 保存文件并关闭，终端输入命令使配置生效：source ~/.zshrc。

在打开的文本文件中，添加以下 3 行内容（JDK 默认安装路径为 /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home，无需修改）：

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

② bash 终端

1. 终端输入命令，编辑 bash 配置文件：open ~/.bash_profile（若文件不存在，先创建：touch ~/.bash_profile）。
2. 添加与 zsh 终端相同的 3 行配置内容。
3. 保存文件并关闭，终端输入命令使配置生效：source ~/.bash_profile。

安装与配置验证

1. 终端中依次输入以下命令，显示正常信息则配置成功：
   • 查看 JDK 版本：java -version（显示'java version "21.0.x"'）。
   • 查看编译器版本：javac -version（显示'javac 21.0.x'）。
   • 查看 JAVA_HOME 路径：echo $JAVA_HOME（显示默认安装路径）。

JDK 安装目录解析

安装完成后，可打开 JDK 安装目录，了解核心文件夹功能，便于后续问题排查：

• bin：存放核心可执行文件，如 javac（编译器）、java（运行器）、jar（打包工具）等。
• jre：Java 运行环境，包含运行 Java 程序所需的虚拟机和核心类库。
• lib：存放 Java 类库文件（.jar 格式），如 tools.jar、dt.jar 等。
• include：存放 C 语言头文件，用于 Java 与 C/C++ 混合开发。
• db：内置的 Derby 数据库，适合小型项目或测试使用。
• src.zip：Java 核心类库的源代码压缩包，便于学习源码。

常见问题排查

命令提示符输入'javac'提示'不是内部或外部命令'

• 原因：环境变量配置错误，或未保存生效。
• 解决：重新检查 JAVA_HOME 路径是否正确，Path 变量是否添加 %JAVA_HOME%\bin，配置后关闭 CMD 重新打开。

安装时提示'权限不足'

• 原因：Windows 系统未以管理员身份运行安装包，macOS 未输入正确开机密码。
• 解决：Windows 右键安装包→'以管理员身份运行'；macOS 确认开机密码输入正确，且有系统安装权限。

下载 JDK 时速度缓慢

• 解决：更换网络（如手机热点），或等待非高峰时段下载；避免使用第三方下载工具，直接通过 Oracle 官网下载更稳定。

macOS 配置后终端仍无法识别 Java 命令

• 原因：配置文件未生效，或终端类型判断错误。
• 解决：重新执行 source ~/.zshrc（zsh 终端）或 source ~/.bash_profile（bash 终端），或重启终端。

总结

JDK 21 作为推荐的长期支持版本，兼顾稳定性和免费商用权益，是 Java 开发的首选环境。通过'下载→安装→配置→验证'四步流程，覆盖 Windows 和 macOS 两大系统的操作细节，每一步都附带关键提示，避免新手踩坑。

配置完成后，即可开启 Java 开发之旅 —— 无论是编写第一个'Hello World'程序，还是使用 IntelliJ IDEA 等工具开发项目，都能正常运行。如果后续需要升级 JDK，只需卸载旧版本，重复本文流程安装新版本，并更新 JAVA_HOME 路径即可。