对于每一位Java开发者而言，正确安装和配置JDK（Java Development Kit）是开启编程之旅的第一步。无论是开发企业级后端应用，还是学习Spring Boot、微服务等热门框架，一个稳定、高效的Java环境都是基石。本文将为你提供一份2025年最新、最详细的JDK 21安装与配置全攻略，覆盖Windows和macOS两大主流操作系统，并深入解析环境变量配置原理，助你轻松避坑，快速搭建专业的Java开发环境。
一、为什么选择JDK 21作为你的开发起点？在众多编程语言如Python、Go、TypeScript蓬勃发展的今天，Java凭借其稳定性、强大的生态系统和跨平台能力，依然是后端开发的中流砥柱。与C++的复杂环境配置相比，Java的JDK安装相对友好。选择JDK 21，主要基于以下核心优势：
长期支持（LTS）：作为官方长期支持版本，JDK 21提供至2026年9月的免费更新，确保生产环境的稳定与安全。免费商用许可：依据Oracle NFTC条款，可免费用于商业生产，无需担忧授权费用。性能飞跃：引入了分代ZGC、虚拟线程等特性，垃圾回收和并发处理能力显著提升。极佳的兼容性：完美支持IntelliJ IDEA、Eclipse、VS Code等主流开发工具和框架。在开始之前，请确认你的系统信息：Windows用户查看系统是64位还是32位；macOS用户需明确是Intel芯片还是Apple Silicon（M1/M2/M3）芯片，这是下载正确版本的前提。
二、从官方安全下载JDK 21安装包为避免第三方捆绑软件，强烈建议从Oracle官网直接下载。访问 Java Downloads | Oracle 官方页面。
在页面上找到“Java 21”区域，点击“JDK Download”按钮进入详细下载页。
根据你的操作系统选择对应的安装包：
Windows：选择“Windows”选项卡下的 x64 Installer (.exe)。这是最便捷的安装方式。macOS (Intel)：选择“macOS”选项卡下的 x64 Installer (.dmg)。macOS (Apple Silicon)：选择“macOS”选项卡下的 ARM64 Installer (.dmg)。
下载前务必勾选“Accept License Agreement”。下载完成后，你可以在“下载”文件夹中找到类似 jdk-21_windows-x64_bin.exe（Windows）或 jdk-21_macos-aarch64_bin.dmg（macOS M芯片）的文件。
[AFFILIATE_SLOT_1]
三、Windows系统：详细安装与环境变量配置1. 执行安装程序双击下载的.exe文件，启动安装向导。你可以使用默认安装路径（如C:\Program Files\Java\jdk-21\），或自定义一个无中文和空格的路径（如D:\Dev\JDK\jdk-21）。
在组件选择界面，确保“开发工具”被选中，它包含了javac、java等核心命令。
等待安装完成即可。
2. 配置环境变量（关键步骤）环境变量的作用是让系统在任何目录下都能识别Java命令。按下Win+R，输入sysdm.cpl，打开“系统属性”，进入“高级”选项卡，点击“环境变量”。
接下来，需要配置三个核心系统变量：
JAVA_HOME：新建一个系统变量，变量名为 JAVA_HOME，变量值为你的JDK安装目录（例如：C:\Program Files\Java\jdk-21）。
Path：编辑已有的Path变量，新建一条记录，值为 %JAVA_HOME%\bin。这会将JDK的bin目录添加到系统搜索路径中。
CLASSPATH（可选）：对于大多数现代项目已非必需。如需配置，可新建变量CLASSPATH，值为.;%JAVA_HOME%\lib\tools.jar。3. 验证安装打开命令提示符（CMD），输入以下命令验证：
java -version
javac -version
如果分别显示JDK 21的版本信息，则表明安装与配置成功！
四、macOS系统：安装与终端配置详解1. 安装过程macOS的安装更为简单。双击下载的.dmg文件，在挂载的磁盘映像中，双击“JDK 21.pkg”安装程序。按照向导提示，同意许可协议并输入管理员密码即可完成安装。默认安装路径为 /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home。
2. 配置终端环境变量macOS的配置主要在终端（Terminal）中进行。首先，需要确定你使用的shell类型：
echo $SHELL
如果输出是/bin/zsh（macOS Catalina及以后版本的默认shell），则编辑zsh配置文件；如果是/bin/bash，则编辑bash配置文件。
对于zsh（推荐）：
open -e ~/.zshrc
如果文件不存在，可以先创建：touch ~/.zshrc。在打开的文件中，添加以下配置：
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
保存后，在终端执行 source ~/.zshrc 使配置立即生效。
3. 验证配置在终端中执行：
java -version
javac -version
echo $JAVA_HOME
正确输出版本信息和JAVA_HOME路径即表示成功。✅
五、深入理解JDK目录结构与常见问题排错安装成功后，了解JDK安装目录的结构有助于后续学习和问题排查：
bin/：核心工具所在，如java, javac, jar。lib/：存放Java类库（.jar文件）。include/：用于JNI（本地接口）开发的C/C++头文件。src.zip：Java标准库的源代码，是深入学习的好材料。⚠️ 常见问题与解决方案：
“javac不是内部或外部命令”：99%的原因是Path变量未正确添加%JAVA_HOME%\bin，或配置后未重启CMD。macOS终端命令不生效：检查shell类型是否正确，并确保执行了source命令或重启了终端。权限不足：Windows请“以管理员身份运行”安装程序；macOS请确保输入了正确的管理员密码。
[AFFILIATE_SLOT_2]
六、总结与新征程的开始至此，你已经成功在Windows或macOS上搭建了基于JDK 21的现代化Java开发环境。这个过程不仅是简单的软件安装，更是理解操作系统如何寻找和执行命令（环境变量的本质）的一次实践。相比于配置Python虚拟环境或Go的模块管理，Java的JDK配置更侧重于系统级的路径设置。
接下来，你可以打开IntelliJ IDEA或VS Code，创建你的第一个Java项目，输出经典的“Hello, World!”，正式踏入Java开发的广阔天地。记住，一个正确配置的环境是高效编码的基础。如果在后续使用或升级JDK过程中遇到问题，回顾本文的环境变量配置部分，往往能迎刃而解。祝你编码愉快！
---
进阶学习
如果你觉得本文有帮助，以下资源可以帮你深入学习：
玩转Spring全家桶
丁雪丰 | 全面掌握Spring生态体系