Java JDK 21 安装与环境配置教程（Windows + macOS）

-   **macOS 系统**：切换到'macOS'选项卡，Intel 芯片选择'x64 Installer'（dmg 格式），M 系列芯片选择'arm64 Installer'（dmg 格式）。

• 步骤 3：下载前需勾选'Accept License Agreement'（接受许可协议），然后点击下载链接。
• 步骤 4：若未登录 Oracle 账号，会提示登录或注册。可使用邮箱快速注册，或选择'跳过登录'（部分地区支持直接下载）。

3. 下载完成验证

下载后找到安装包（默认在'下载'文件夹）：

• Windows：文件名为'jdk-21_windows-x64_bin.exe'

• macOS：文件名为'jdk-21_macos-x64_bin.dmg'（Intel 芯片）或'jdk-21_macos-aarch64_bin.dmg'（M 芯片）

四、Windows 10/11 系统：JDK 安装与配置

1. 分步安装 JDK 21

双击下载的 exe 安装包，弹出安装向导，点击'下一步'。

选择安装目录（建议默认路径，如'D:\App\JDK\jdk-21'，便于后续配置；若需自定义路径，需记住安装位置，避免中文路径）。

勾选'开发工具'（必须勾选，包含 javac 编译器、java 运行器等核心工具），其他组件默认即可，点击'下一步'。

等待安装进度条完成（约 1-2 分钟），点击'关闭'，安装完成。

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

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

（1）打开环境变量配置窗口

• 方法 1：右键'此电脑'→'属性'→'高级系统设置'→'环境变量'。

• 方法 2：按下 Win+R，输入'sysdm.cpl'，回车→切换到'高级'选项卡→'环境变量'。

（2）配置系统变量（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（注意开头的英文句号，代表当前目录）。
• 点击'确定'保存。

（3）保存所有配置

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

3. 安装与配置验证

按下 Win+R，输入'cmd'，打开命令提示符（CMD）。依次输入以下 3 条命令，若均显示正常信息，则说明安装配置成功：

• 查看 JDK 版本：java -version（显示'java version "21.0.x"'等信息）。
• 查看编译器版本：javac -version（显示'javac 21.0.x'等信息）。

五、macOS 系统：JDK 安装与配置

1. 分步安装 JDK 21

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

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

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

（1）查看终端类型

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

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

（2）配置环境变量

① 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。

3. 安装与配置验证

终端中依次输入以下命令，显示正常信息则配置成功：

• 查看 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 核心类库的源代码压缩包，便于学习源码。

七、常见问题排查

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

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

2. 安装时提示'权限不足'

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

3. 下载 JDK 时速度缓慢

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

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

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

八、总结

JDK 21 作为推荐的长期支持版本，兼顾稳定性和免费商用权益，是 Java 开发的首选环境。通过'下载→安装→配置→验证'流程，覆盖 Windows 和 macOS 两大系统的操作细节。配置完成后，即可开始编写第一个