跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Javajava

Java JDK 21 安装与环境配置指南(Windows + macOS)

JDK 21 作为长期支持版本,兼顾稳定性与免费商用权益。详细演示了 Windows 和 macOS 系统下的 JDK 下载、安装流程及环境变量配置方法,包含验证命令与常见错误排查,助开发者快速搭建运行环境。

邪神洛基发布于 2026/3/15更新于 2026/9/1073 浏览
Java JDK 21 安装与环境配置指南(Windows + macOS)

Java 作为后端开发的核心语言,JDK(Java Development Kit)是开发和运行 Java 程序的基础环境。目前推荐安装 JDK 21——这是 Java SE 平台的长期支持(LTS)版本,可免费用于生产环境及重新分发。本文将针对 Windows(10/11)和 macOS(Intel/M 芯片)两大主流系统,提供从官方下载、分步安装到环境变量配置的完整流程,附带验证步骤和常见问题排查。

一、JDK 21 核心优势

  1. 长期支持更稳定:作为 LTS 版本,提供更长的技术支持周期,兼容性强,适合开发、测试及生产环境。
  2. 免费商用权益:根据 Oracle 无费用条款(NFTC),JDK 21 二进制文件可免费用于生产场景,无需额外付费授权。
  3. 性能与功能升级:优化了垃圾回收机制,增强了并发处理能力,同时兼容主流开发工具(IntelliJ IDEA、Eclipse 等)。
  4. 跨平台适配:支持 Windows、macOS、Linux 等多种操作系统。

二、前期准备:确认系统版本

安装前需明确电脑操作系统及硬件架构,避免下载错误版本:

  • Windows 系统:右键'此电脑'→'属性',查看系统类型(64 位 / 32 位,目前主流为 64 位)。
  • macOS 系统:点击左上角'苹果图标'→'关于本机',查看芯片类型(Intel 芯片 / M 系列芯片,如 M1、M2、M3)。

三、官方下载 JDK 21

1. 访问 Oracle 官方下载地址

打开浏览器,输入官方下载链接:Java Downloads | Oracle。建议直接访问官网,避免第三方镜像站的捆绑软件。

文章配图

文章配图

选择适合 JDK 版本,本文以 JDK 21 为例,在 Windows x64 环境下安装 x64 Installer。

选择建议:

普通用户:选择 x64 Installer,简便、快速。
开发者或需要灵活控制安装位置的用户:选择 x64 Compressed Archive,需要手动设置环境变量。
IT 管理员或批量部署:选择 x64 MSI Installer,适合批量安装和企业环境。

2. 选择对应系统版本下载
  • 步骤 1:页面下拉找到'Java 21'相关下载区域,点击'JDK Download'进入下载页面。

文章配图

(注:原图链接保留)

  • 步骤 2:根据操作系统选择对应版本:
    • Windows 系统:切换到'Windows'选项卡,点击'x64 Installer'(exe 格式,约 200MB),适合 64 位 Windows 10/11。

文章配图

  • 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 终端(推荐)

终端输入命令,编辑 zsh 配置文件:open ~/.zshrc(若文件不存在,先创建:touch ~/.zshrc)。保存文件并关闭,终端输入命令使配置生效: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 两大系统的操作细节,每一步都附带关键提示,避免新手踩坑。配置完成后,即可开启 Java 开发之旅 —— 无论是编写第一个'Hello World'程序,还是使用 IntelliJ IDEA 等工具开发项目,都能正常运行。如果后续需要升级 JDK,只需卸载旧版本,重复本文流程安装新版本,并更新 JAVA_HOME 路径即可。

目录

  1. 一、JDK 21 核心优势
  2. 二、前期准备:确认系统版本
  3. 三、官方下载 JDK 21
  4. 1\. 访问 Oracle 官方下载地址
  5. 2\. 选择对应系统版本下载
  6. 3\. 下载完成验证
  7. 四、Windows 10/11 系统:JDK 安装与配置
  8. 1\. 分步安装 JDK 21
  9. 2\. 环境变量配置(关键步骤)
  10. (1)打开环境变量配置窗口
  11. (2)配置系统变量(3 个核心变量)
  12. ① 新建“JAVA_HOME”变量
  13. ② 配置“Path”变量
  14. ③ (可选)新建“CLASSPATH”变量
  15. (3)保存所有配置
  16. 3\. 安装与配置验证
  17. 五、macOS 系统:JDK 安装与配置
  18. 1\. 分步安装 JDK 21
  19. 2\. 环境变量配置(分终端类型)
  20. (1)查看终端类型
  21. (2)配置环境变量
  22. ① zsh 终端(推荐)
  23. ② bash 终端
  24. 3\. 安装与配置验证
  25. 六、JDK 安装目录解析
  26. 七、常见问题排查
  27. 1\. 命令提示符输入“javac”提示“不是内部或外部命令”
  28. 2\. 安装时提示“权限不足”
  29. 3\. 下载 JDK 时速度缓慢
  30. 4\. macOS 配置后终端仍无法识别 Java 命令
  31. 八、总结

更多推荐文章

查看全部
  • AI 绘画提示词风控:Qwen3Guard-Gen-8B 前置审核实战
  • Linux 下 C/C++ 调试工具 gdb 与 cgdb 实战指南
  • 大疆测试岗实习面试全流程复盘
  • JavaScript 基础语法与 jQuery 快速入门
  • jQuery 核心实战:选择器、DOM 操作与表单验证详解
  • Linux 网络传输层详解:UDP 与 TCP 协议原理
  • Android 面试复盘:高频考点与准备思路
  • OpenClaw 框架下 Discord AI 机器人部署指南
  • Vheer:免费免登录 AI 绘画视频生成与智能编辑工具
  • AI 可能引发大规模生物风险,专家呼吁建立跨学科团队
  • 基于 FPGA 的北斗导航自适应抗干扰算法设计与实现
  • Midjourney 第三方 API 服务技术原理与合规实践
  • 神经网络优化策略与工程实践
  • LeetCode 964. 最少运算符表示数字
  • OpenClaw 接入飞书:让 AI 机器人直接操作文档与表格
  • 二分算法实战:查找元素范围及区间统计
  • 纯前端开源 PDF 压缩工具:Vue3+TypeScript 实现方案
  • Visual Studio 使用 GitHub Copilot 与 IntelliCode 辅助编码
  • 基于 DeepSeek 和 Cursor 构建智能代码审查工具实践
  • 大模型智能体驱动的社会模拟:从个体到社会

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online