Windows安装OpenJDK 21指南：环境变量配置与多版本共存-北京尧图网络

简介OpenJDK 21 Windows x64 开发工具包是面向 Java 开发者在 64 位 Windows 平台获取最新开源 Java 能力的完整软件包解决了在 Windows 环境中快速获取、安装与配置最新 Java 开发运行环境的问题。该版本遵循 GPLv2 许可与 Oracle JDK 保持高度同步内含 JRE 运行环境以及 javac、javadoc 等编译与文档工具可快速搭建本地开发测试环境。压缩包为 zip 格式共 484 个文件其中 dll 动态库提供底层运行支持jmod 模块文件存放 Java 类库模块exe 可执行程序是 java、javac 等命令入口另附 md 说明与 license 许可等材料整体约 189.2MB。已有 571 人浏览学习适合希望抢先体验非长期支持版本、验证 JEP 新特性的开发者。由于当前为早期预览版稳定性尚待完善生产环境建议搭配 LTS 版本使用。下载解压后即可获得完整工具链免去源码编译与复杂配置便于本地开发、课堂演示、技术预研及新功能评估。安装前需确认系统为 Windows x64 架构。1. 装 OpenJDK 21 这事比想象中更容易翻车OpenJDK 21 在 Windows x64 上的安装本应该是五分钟搞定的事下载、解压、配环境变量、验证版本。但我见过太多人在这一步卡住——不是下载链接选错就是环境变量配了等于没配更常见的是装完后java -version显示的还是旧版本让人一脸懵。尤其是那些刚接触 Java 的开发者第一次在 Windows 上配 JDK常常对着教程上一个版本号发愣Oracle JDK、OpenJDK、Adoptium、Liberica……到底哪个才是 OpenJDK 21它们之间有什么差别先说结论如果你想要一个干净、开源、无版权风险的 JDK 21并且是 Windows x64 平台推荐直接选用 Eclipse Adoptium原 AdoptOpenJDK构建的 OpenJDK 21。这个发行版是目前社区中最主流的选择更新及时、安装包友好、生态支持完善。但下载只是开始真正容易踩坑的地方在后面环境变量路径中带了空格、把 JDK 装到了带中文的目录、JAVA_HOME指到了 jre 目录而不是 jdk 目录——这些看似小的问题能让你在启动 IDE 或构建工具时接到一串莫名其妙的报错。这篇文章面向的正是卡在安装和配置阶段的开发者。我按自己的实际部署经验把从版本选择、下载安装、环境变量配置、多版本共存到环境验证和故障排查的完整流程写出来。每一步的命令、参数、判断依据都给到照着走十分钟内应该能跑通java -version。老手也能从多版本共存和排查部分获得一些参考价值。2. 版本选择与下载先搞清楚你要的是哪个 OpenJDK 212.1 为什么选择 Adoptium 的 OpenJDK 21OpenJDK 21 是一个比较特殊的版本。它是继 JDK 17 之后的下一个长期支持版本LTS官方承诺提供至少五年的安全更新和 bug 修复。这意味着对于生产环境、企业级项目21 是一个值得投入的版本。但 OpenJDK 本身只是源代码你实际安装的是某个发行方构建好的二进制包不同发行方在稳定性、认证、许可证、更新节奏上都有差异。目前适合 Windows x64 的 OpenJDK 21 发行版主要有这么几个发行方许可证特点适用场景Oracle OpenJDKGPLv2CE官方构建与 Oracle JDK 行为一致追求与官方完全一致不在意 Orace 商标Eclipse AdoptiumTemurinGPLv2CE社区主导更新稳定安装包体验好推荐大多数开发者使用Amazon CorrettoGPLv2CEAmazon 维护长时间支持已有 AWS 生态或需要更长维护期Microsoft Build of OpenJDKGPLv2CE微软构建Azure 环境兼容使用 Azure 或 Visual Studio 的团队Liberica JDKGPLv2CE包含 JavaFX 版本需要自带 JavaFX 的场景我一般用 Adoptium 的 Temurin 发行版。原因有三第一社区活跃度高问题响应快第二它的 Windows 安装包.msi做得很好自动配置环境变量、注册表项和文件关联省掉手动配置环节第三它同时提供 JDK 和 JRE实际上 JDK 里已包含 JRE 的功能只是没有单独的 JRE 目录自 JDK 9 之后官方就不提供独立 JRE 了不必担心选错。提示自 JDK 9 起官方不再发布独立的 JRE。JDK 目录本身就是完整的运行时环境jlink可以生成精简运行时但日常开发直接用 JDK 即可。2.2 下载地址与版本号的确认方法下载页上会显示大量版本信息不要凭记忆选。我一般这样做打开 Adoptium 官网的下载页adoptium.net /temurin/releases。Operating System 选 WindowsArchitecture 选 x64Version 选 21。在 Released builds 列表里找到最新的 21 LTS 版本比如21.0.511或更近的版本号。这里的21是 Java 特性版本号0.5是安全更新版本11是 Adoptium 自己的构建号。安装时注意选择Install.msi 安装包而不是Portable压缩包。下载.msi文件。同时建议把文件哈希值SHA256复制下来下载完成后校验一下防止文件损坏或被篡改。校验哈希可以使用 PowerShellGet-FileHash .\OpenJDK21-windows-x64.msi -Algorithm SHA256输出的哈希值与官网展示的对比。如果不一致重新下载。我遇到过下载中途断线导致 msi 文件不完整的情况安装时直接报错“无法访问 Windows 安装服务”所以校验这一步别跳过。2.3 安装前的 Windows 环境检查在开始安装之前确认你的 Windows 版本满足运行要求。OpenJDK 21 官方支持 Windows 10、Windows 11 以及 Windows Server 2016 以上的系统。比较老旧的 Windows 7 用户可能要失望——JDK 21 的团队明确表示不再支持 Windows 7即使强行安装某些功能也无法正常工作。检查方式systeminfo | Select-String OS Name,OS Version另外确认系统架构是 x6464 位现在主流机器几乎都是但仍有少部分 32 位系统还在服役。用下方命令确认echo %PROCESSOR_ARCHITECTURE%输出结果为AMD64就说明是 64 位系统可以安装 x64 版本的 JDK。如果是x86需要另找 32 位版本的构建但 Adoptium 对 32 位 Windows 的支持逐年收窄JDK 21 大概率没有 32 位版本这种情况我建议先升级系统不要试图强行部署。3. 安装 OpenJDK 21MSI 安装与免安装解压两套方案3.1 方案一MSI 安装包推荐新手使用Adoptium 的 Windows.msi安装包做得相当完善基本可以做到“下一步”到底。但里面的几个配置项需要注意我明确说一下我的选择Install Location: C:\Program Files\Eclipse Adoptium\jdk-21.0.511 JavaSoft (Oracle) registry keys: 选上 Set JAVA_HOME variable: 选上非常重要的步骤 Set PATH variable: 选上推荐免去手动配 PATH Set CLASSPATH variable: 不选现代 Java 开发不需要设置 CLASSPATH JavaSoft (Oracle) registry keys: 选上保持兼容性选择安装路径时尽量不要修改默认路径或者如果修改务必保证路径中没有空格和中文。虽然新版本的 JDK 在路径含空格时基本也能工作但 Maven、Gradle、某些老旧的构建脚本经常会在引号处理上出问题为了省心保持默认或者用一个简单的短路径比如C:\jdk21能省掉很多玄学报错。参数说明JAVA_HOME是 Windows 上各种 Java 工具链Maven、Gradle、Tomcat 等查找 JDK 的首选环境变量必须设置。PATH变量决定了你在命令行里直接敲java命令时系统去哪些目录找程序。安装包自动帮你设置的话省去了手动拼路径的麻烦。CLASSPATH变量在 JDK 9 时代基本不需要手动设置因为 Java 默认就可以从当前目录加载类设置不当反而会引起类冲突。3.2 方案二ZIP 免安装包适合需要精确控制的场景如果你不想在系统里留下注册表记录或者在多台机器上快速复制环境用.zip免安装包更合适。我自己的服务器上基本都是这么干的。步骤从官网下载.zip压缩包文件。解压到一个固定目录例如C:\jdk21。注意目录名不要用jdk-21这样的带版本号目录升级时要改路径麻烦。我用一个不带版本号的目录再结合软链或环境变量切换版本会灵活很多。解压后确认目录结构bin、conf、include、lib、legal等目录都在。C:\jdk21\bin\java.exe -version如果输出如下内容说明解压包本身可用openjdk version 21.0.5 2025-10-21 LTS OpenJDK Runtime Environment Temurin-21.0.511 (build 21.0.511- LTS) OpenJDK 64-Bit Server VM Temurin-21.0.511 (build 21.0.511- LTS, mixed mode, sharing)注意第三行的64-Bit Server VM说明这是 x64 版本的 JVM。如果这里显示Client VM或32-Bit说明下载了错误的版本。3.3 安装完成后的目录结构说明无论用哪种方案安装JDK 21 的目录结构基本一致。其中几个重要目录bin -- 可执行文件java、javac、javadoc、jlink、jar 等 conf -- JDK 自身配置文件 include -- JNI 编程所需的 C 头文件 legal -- 许可证文件 lib -- 运行时依赖的库和模块自 JDK 9 引入模块化后JDK 的目录里没有单独的jre目录了。很多人拿到一个老教程看到JAVA_HOMEC:\Program Files\Java\jdk-21\jre这样的配置直接照抄结果报错“系统找不到指定的路径”。我见过不下十次这种情况。记住JDK 21 的根目录就是运行时根目录不要指向任何子目录。4. 环境变量配置三个最容易写错的路径细节4.1 JAVA_HOME 的配置方法安装完成后环境变量是让命令行找到 java 的关键。如果你用 MSI 安装包并勾选了自动配置这一步可以跳过但我建议手动检查一遍因为安装包的自动配置有时会因为系统中存在旧版 JDK 而混乱。打开环境变量配置面板右键“此电脑” → 属性 → 高级系统设置 → 环境变量。在“系统变量”下方点击“新建”创建JAVA_HOME变量名JAVA_HOME 变量值C:\Program Files\Eclipse Adoptium\jdk-21.0.511重点变量值必须是 JDK 的根目录也就是bin目录的上一级。最容易写错的地方是把路径写到bin目录导致JAVA_HOME\bin\java.exe变成bin\bin\java.exe。路径末尾多加了反斜杠即C:\...\jdk-21.0.511\某些工具会因此拼接出错。路径中带了双引号Windows 的环境变量设置里不需要加引号。4.2 PATH 的追加与优先级管理修改Path系统变量在变量值的最前面或最后面追加%JAVA_HOME%\bin%JAVA_HOME%\bin;原有内容保持不变我建议把%JAVA_HOME%\bin放在 Path 的最前面。为什么Windows 查找命令时按 Path 变量的顺序依次查找如果系统里还残留了其他 JDK 版本的java.exe则先被找到的会生效。把新版本 JDK 的 bin 目录放在最前面能保证命令行里的java -version显示的是你想要的版本。如果是通过“编辑”对话框直接操作不需要写%JAVA_HOME%的展开形式可以直接粘贴完整路径效果一样。但建议保留%JAVA_HOME%这样以后升级 JDK 时只需要改JAVA_HOME一个变量不用同时改 Path。4.3 验证环境变量的正确姿势配置完环境变量后需要重新打开命令行窗口才能生效。以下是完整的验证命令序列echo %JAVA_HOME% echo %PATH% java -version javac -version where java说明echo %JAVA_HOME%输出 JAVA_HOME 的实际值检查路径是否拼写正确。echo %PATH%检查 Path 变量里是否包含了C:\Program Files\Eclipse Adoptium\jdk-21.0.511\bin。java -version输出 JVM 版本信息确认主版本是 21。javac -version输出编译器版本确认 javac 可用。where java显示实际被调用的 java.exe 的完整路径用来判断到底用的是哪个 JDK。这一点非常重要尤其是系统里有多个 JDK 的时候。如果java -version输出了旧版本十有八九是 Path 里旧版本路径排在前面用where java一看就知道。下文我会展开这个坑的解决办法。5. 多版本 JDK 共存与切换别让旧版本绑架你的环境5.1 为什么需要多个 JDK 共存在实际开发中你很难只装一个 JDK。老项目可能锁定在 JDK 8 或 11 上新项目用 21又或者你想尝鲜用 JDK 23 的功能。直接卸载旧版本再装新版会影响正在运行的旧项目不卸载旧版本环境变量又会被旧的霸占。这是几乎每个开发者都会遇到的场景。Adoptium 的 MSI 安装包默认会把不同版本的 JDK 安装到不同的目录版本号不同目录名自然不同所以共存本身不是问题问题在于环境变量只有一个JAVA_HOME怎么切换才是重点。我的做法是安装所有需要的 JDK 版本然后用环境变量快速切换。这个方法不需要任何第三方便携工具纯 Windows 原生能力就能做到。5.2 版本切换的两种实用方法方法一手动修改 JAVA_HOME。在系统中规划几个固定目录C:\jdk8 C:\jdk11 C:\jdk21 C:\jdk23每个目录对应一个版本的 JDK 根目录把新版本安装时默认的目录改为这些无版本号目录或者安装后把目录复制过去。然后每次切换时只需编辑JAVA_HOME的值。setx JAVA_HOME C:\jdk21重新打开命令行java -version就会变成 21。这个方法简单可靠代价是手动操作。切换频率不高时足够用。方法二使用软链接Symlink配合版本编号。不用反复修改 JAVA_HOME而是创建软链接指向一个固定的current目录mklink /D C:\jdk-current C:\jdk21然后把JAVA_HOME指向C:\jdk-current以后切换版本时只需要用命令行重建这个软链接# 先删除旧的链接注意不是删除链接指向的目录 rmdir C:\jdk-current # 再创建新链接指向目标版本 mklink /D C:\jdk-current C:\jdk23这样 JAVA_HOME 永远指向C:\jdk-current实际生效的版本由软链接决定。这个方法避免了反复修改系统变量的操作也天然解决了 IDE 缓存旧路径的问题。但要注意rmdir操作的是 soft link 本身不会误删它指向的真实 JDK 目录。确认这一点后再动手免得把 JDK 文件都删没了。5.3 工程级配置用 Maven/Gradle 指定 JDK 版本环境变量只管全局具体项目往往需要锁定到特定 JDK 版本。Maven 中是靠JAVA_HOME环境变量决定用哪个 JDK 运行编译但在pom.xml中显式声明编译目标版本maven.compiler.source21/maven.compiler.source maven.compiler.target21/maven.compiler.targetGradle 中则更灵活可以在build.gradle里指定java { toolchain { languageVersion JavaLanguageVersion.of(21) } }Gradle 工具链toolchain会自动探测系统中已安装的 JDK并在需要时自动选用对应版本。如果探测不到Gradle 还可以自动下载 JDK——这是我在多个开发机器上非常喜欢的功能。指定版本后即使环境变量指向的是 JDK 8Gradle 也会用项目要求的 JDK 21 来编译减少“本地能编译别人机器上失败”的尴尬。提示如果同时使用 IDEIDEA、EclipseIDE 里也可能配置了各自的 JDK 路径。环境变量、命令行、IDE 三者的 JDK 版本要保持一致否则你会看到同一个项目在终端里用 21 编译在 IDE 里却用 8 编译的怪异现象。6. 常见问题排查五个高频的 OpenJDK 21 安装坑6.1 java -version 输出旧版本号现象安装完成后在命令行执行java -version显示的却是旧版本比如 1.8 或 17。原因Path 环境变量中旧版本的java.exe所在目录排在 JDK 21 目录之前系统优先调用了旧版本。这种情况在安装过 Oracle JDK、或通过其他方式安装过多个 JDK 的机器上非常常见。解决先执行where java看看实际调用的路径。打开环境变量面板编辑Path把%JAVA_HOME%\bin或 JDK 21 的 bin 目录移动到所有其他 JDK 相关路径的最上面。重新打开命令行验证。如果where java列出了多个路径除了 Path 中显式声明的之外Windows 还会搜索当前目录和系统目录System32。检查一下C:\Windows\System32\java.exe是否存在有些软件会往系统目录里注入 java.exe。如果存在但是旧版本可以删掉或重命名但要确认它不属于其他软件依赖。6.2 javac 提示“不是内部或外部命令”现象java -version正常但执行javac -version时命令行提示“不是内部或外部命令”。原因Path 中只配置了%JAVA_HOME%\bin但JAVA_HOME变量值设置错误或为空导致%JAVA_HOME%\bin展开后不生效。另外某些 MSI 安装包只配置了 PATH 而没有配置 JAVA_HOME也会出现这种情况。解决echo %JAVA_HOME%如果输出为%JAVA_HOME%原样说明系统变量没有生效重新正确配置后重启命令行。如果 JAVA_HOME 值正确再检查 Path 里是否写的是%JAVA_HOME%\bin而不是%%JAVA_HOME%%\bin拼写错误也是我见过多次的低级失误。6.3 安装 MSI 失败并提示“正在准备另一个安装”现象双击 MSI 安装包弹出窗口提示错误代码 1618 或“另一个安装正在进行中”安装无法继续。原因Windows Installer 不允许同时运行多个 MSI 安装进程。后台可能残留了之前的安装进程或者 Windows Update 等系统进程正在占用安装服务。解决打开任务管理器结束所有msiexec.exe进程。在服务中确认Windows Installer服务状态如果停止则启动。重启电脑后再试一次。这个坑主要出现在不干净的重装环境中新装系统则很少见。6.4 JAVA_HOME 路径中包含空格导致构建失败现象IDE 启动正常命令行 java 正常但执行 Maven 构建时报错The JAVA_HOME environment variable is not defined correctly this environment variable is needed to run this program原因JAVA_HOME 指向的路径含有空格如C:\Program Files\...某些脚本在解析时没有正确处理带引号的路径导致找不到 JDK。解决配置 JAVA_HOME 时不要手动加引号如果是在命令行用setx设置可以加引号避免空格被截断但在 GUI 里不要写引号。更稳妥的做法是方案二把 JDK 复制到无空格目录如C:\jdk21再从根源上避免这类问题。我在Windows 服务器上部署时也会经常遇到脚本对空格处理不到位的情况所以统一用无空格目录。6.5 明明安装成功启动 Spring Boot 项目却报“UnsupportedClassVersionError”现象Spring Boot 项目启动时出现java.lang.UnsupportedClassVersionError: org/springframework/boot/... has been compiled by a more recent version of the Java Runtime原因项目的编译目标版本高于当前 JVM 版本或者当前 JVM 版本号低于项目要求。这个报错和安装本身没直接关系但在刚装完新 JDK 后经常出现通常是 IDE 使用的 JDK 不是刚装的 21。解决在 IDE 中检查 Project Structure → SDK / Project SDK 是否选择了 21。确认 Maven 或 Gradle 的运行时 JDK 是否切换到了 21。检查pom.xml中java.version是否设置为 21同时保证 IDE 的字节码版本设置为 21。7. 装完后的验证与收尾让环境跑一次完整的 Java 21 链路7.1 验证 Java 编译与运行环境变量配好后最终验证不能只停留在java -version。我会强制自己走过一遍“编写 → 编译 → 运行”的全流程这样任何隐藏的环境问题都会暴露出来。先创建测试文件public class Java21Check { public static void main(String[] args) { // Java 21 新增的虚拟线程特性简单验证运行时是否支持 Thread.ofVirtual().start(() - System.out.println(Virtual Thread OK)); // 验证文本块特性 String textBlock Java 21 is running. ; System.out.println(textBlock); System.out.println(Java Version: Runtime.version()); } }保存为Java21Check.java文件名必须与 public 类名一致然后在命令行执行javac Java21Check.java java Java21Check正常情况下的输出Virtual Thread OK Java 21 is running. Java Version: 21.0.511-LTS这个验证脚本同时验证了javac 编译器可用、JVM 能正确加载编译后的 class 文件、Java 21 的新特性虚拟线程、文本块都能正常工作。如果这步跑通说明安装链路完全没有问题。7.2 检查关键工具链是否连通编译运行跑通后再把构建工具链快速验证一遍。我通常会在某个临时项目目录里执行mvn -version输出中会包含 Java 版本信息和 Maven 使用的JAVA_HOME。确保输出中的 Java 版本确实是 21而不是系统默认的旧版本。同样确认 Gradlegradle --version这两个工具如果显示版本正确说明JAVA_HOME和PATH的配置被工具链正确识别了。如果工具版本显示的是旧版本多版本切换那节的思路就要派上用场了。7.3 卸载旧版本时的注意事项如果你的目的是彻底用 21 替换旧版本在卸载旧 JDK 前先确认没有其他项目依赖它。确认方式用setx临时修改 JAVA_HOME 后重启项目跑一遍即可。卸载时通过“控制面板 → 程序 → 程序和功能”找到旧版 JDK卸载。卸载后检查环境变量里是否还残留旧路径清理干净。残留的java.exe是“后患”不清理干净下次装新版本时旧版本还可能“借尸还魂”。7.4 我的一点习惯装过太多系统后我现在养成的习惯是每次装完 JDK不论在个人电脑还是部署服务器上都强制走一遍上面的javac Java21Check.java编译运行流程然后再跑一次mvn -version最后看一眼where java的输出。这条链路走完我才敢说环境是干净的。有时候看起来配得好好的环境“玄学”报错不断排查到最后就是某个细节没到位。如果你按本文流程装好了 OpenJDK 21 并通过了验证恭喜你这套环境至少不会再在版本和配置上给你添乱。如果还有没覆盖到的坑多看看报错日志里的路径信息多半能找到线索。希望这些经验和教训帮到你——装的版本多了就知道一块地砖哪块松哪个井盖该绕着走。按照文中的步骤走一次五分钟后在命令行看到openjdk version 21.0.5的那一刻环境这事儿就算底定了一半。本文还有配套的精品资源点击获取

Windows安装OpenJDK 21指南：环境变量配置与多版本共存

相关推荐

eWebEditor V12.0 ASP商业版部署与安全配置指南

AC5迁移AC6前必读：ARM Compiler 5.06兼容性避坑指南

终端AI编程助手实践手册：从Claude Code到hooks与MCP的完整指南

更多资讯

手把手教你｜投票制作怎么做：数据导出 + 防刷票，年会 / 比赛评选该选哪个（附对照表）

Java+AI全栈开发工程师：核心能力、技术栈与实战指南

高低温试验设备行业现状、解决方案及采购选型指南

三网回程线路如何识别：TcpQuality中traceroute、ASN查询与nexttrace协同工作流程

量子哲学概念| 赵杰 | 量子哲学

HanLP中文分词实战：词典分词与二元语法从实验到落地

今日更新

Cephadm实战指南：Linux系统工程师的生产级Ceph集群部署与排障

不想再被 Token 额度卡脖子？把免费 API 接入 WorkBuddy 的完整教程

ITK中SpatialObject几何体系解析：坐标系、变换与管道集成

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？