JDK21下载安装及环境配置教程

本文手把手教你如何在 Windows 系统上快速、零踩坑地完成 JDK 21 的下载安装与 JAVA_HOME 环境变量配置，直击新手最常犯的三大致命错误：误选 ZIP 包、路径含空格或中文、JAVA_HOME 错填至 bin 目录，并强调使用 Eclipse Temurin 的 MSI 安装包、纯英文无空格安装路径、JAVA_HOME 必须精准指向 JDK 根目录、Path 中仅添加 %JAVA_HOME%\bin 等关键实践，确保 java -version 正常输出、Maven/Gradle/IDEA 等开发工具无缝识别，省去反复排查环境问题的时间。

直接装 JDK 21 并配好 JAVA_HOME，关键就三步：选对安装包、装到干净路径、变量值必须指向 JDK 根目录（不是 bin）。错一步，java -version 就会报“不是内部或外部命令”，Maven/Gradle/IDEA 也会找不到 JDK。

下载 JDK 21：优先选 MSI 安装包，别碰 ZIP 或 Oracle 账户登录陷阱

Windows 用户直接去 Adoptium（Eclipse Temurin）官网 下载，比 Oracle 官网省事——不用注册、免登录、版本更新及时、开源可信。找带 jdk_x64_windows_hotspot 和 msi 后缀的安装包，比如：OpenJDK21U-jdk_x64_windows_hotspot_21.0.4_7.msi。

不推荐 Oracle 官网的 ZIP 包（tar.gz 或 zip），它不会自动注册路径，后续全靠手动配，新手极易漏掉 Path 或写错 JAVA_HOME；也别硬刚 Oracle 账户登录，容易卡在验证环节，纯增加无意义阻塞。

• MSI 安装包双击运行后，点“下一步”即可，中间可点击 Change 自定义路径
• 路径务必选纯英文、无空格、无中文，例如：C:\dev\jdk-21.0.4，千万别用 C:\Program Files\Java\...（空格会导致部分旧脚本解析失败）
• 安装最后一页，取消勾选“Add to PATH”——这个选项只加了 bin 目录，但没设 JAVA_HOME，反而会让环境变量逻辑混乱

JAVA_HOME 必须填 JDK 根目录，填错 bin 是最高频错误

JAVA_HOME 的值不是 C:\dev\jdk-21.0.4\bin，也不是 C:\dev\jdk-21.0.4\jre，就是 C:\dev\jdk-21.0.4 这个文件夹本身。几乎所有 Java 工具（Maven、Gradle、Tomcat、IntelliJ IDEA）都靠读取这个变量定位 JDK，填错等于告诉它们“工具箱在柜子顶上”，结果它们翻遍整个柜子也找不到扳手。

• 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”
• 在“系统变量”区域点“新建”，变量名写 JAVA_HOME，变量值粘贴你刚才记下的完整根路径
• 确认路径末尾没有斜杠（\），也不带 bin、jre 等子目录名

Path 里加 %JAVA_HOME%\bin，不是绝对路径，更不能重复添加

只在 Path 里新增一条：%JAVA_HOME%\bin。这样做的好处是：以后换 JDK 版本，只要改一个 JAVA_HOME 值，所有依赖它的命令（java、javac、jar）自动切换，不用挨个改 Path。

• 不要手敲完整路径如 C:\dev\jdk-21.0.4\bin，否则 JAVA_HOME 就形同虚设
• 检查 Path 里是否已有其他 JDK 的 bin（比如残留的 C:\Program Files\Common Files\Oracle\Java\javapath），有就删掉，避免版本冲突
• 改完点“确定”保存，**必须新开一个 CMD 或 PowerShell 窗口**再验证，旧窗口不会自动加载新变量

验证时执行两行命令：echo %JAVA_HOME% 应该输出你设的路径；java -version 应显示 openjdk version "21.0.4"。如果前者对后者错，说明 Path 没生效或有旧路径干扰；如果两者都错，大概率是 JAVA_HOME 值多写了 \bin 或路径根本不存在——这时候别猜，直接进资源管理器手工打开那个路径，看文件夹是否存在、名字是否拼错。

本篇关于《JDK21下载安装及环境配置教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！