正确安装 jdk 21 的核心是选对安装包、装到合规路径、精准配置环境变量;需避开空格、中文、硬编码路径三类坑,下载优先选 msi 格式(如 eclipse temurin),路径用 c:\dev\jdk-21 等纯英文无空格目录,仅配 java_home 和 path(含 %java_home%\bin),验证须用新命令行执行 echo %java_home%、java -version、javac -version 三命令。

正确安装 JDK 21 的核心是:选对安装包、装到合规路径、精准配置环境变量。只要避开空格、中文、硬编码路径这三类常见坑,基本一次成功。
下载时选对安装包类型
Windows 用户优先选 .msi 格式(如 Eclipse Temurin 提供的 OpenJDK21U-jdk_x64_windows_hotspot_*.msi),它支持标准安装流程、注册表写入和干净卸载;不推荐 Oracle 官网默认的 .exe 安装器(本质是自解压包,易带捆绑软件且不自动注册 JAVA_HOME)。
务必确认文件名含 “msi” 后缀,下载时用 Chrome 或 Edge,Firefox 可能拦截 .msi 文件。
安装路径要干净无干扰
安装过程中点击“更改”按钮,手动指定路径:
• 推荐使用 C:\dev\jdk-21 或 D:\jdk21 这类纯英文、无空格、无中文、无特殊符号的路径
• 可以接受默认的 C:\Program Files\Java\jdk-21,但后续环境变量中必须用 %JAVA_HOME%\bin 引用,不能直接硬写带空格的完整路径
• 绝对避免桌面、文档、下载文件夹等同步目录,也别用含“Java”以外中文字符的路径
环境变量只配两项关键内容
右键“此电脑” → “属性” → “高级系统设置” → “环境变量”:
• 新建系统变量:
变量名:JAVA_HOME
变量值:C:\dev\jdk-21(注意:结尾不加 \bin,也不加反斜杠)
• 编辑系统变量 Path:
新增一行:%JAVA_HOME%\bin
把这一项拖到 Path 列表最顶部,确保优先调用
• 安装时如果出现“Add to PATH”勾选项,一律取消——它会硬写含空格路径,导致 Gradle、Maven 等工具解析失败
验证必须用新窗口+三命令
关掉所有已有命令行窗口,**全新打开一个 CMD 或 PowerShell**:
• echo %JAVA_HOME% —— 应输出你设置的路径,且该路径下存在 bin、lib、jmods 等文件夹
• java -version —— 显示类似 java version "21.0.7" 2026-04-16 LTS,含 “21.” 和 “LTS”
• javac -version —— 输出完全一致的版本号,证明编译器就绪
三项全通过,说明 JDK 21 已真正可用。若 javac 报错,90% 是 JAVA_HOME 多写了 \bin,或 Path 里混入了旧 JDK 的硬编码路径。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











