Windows 11 安装 Zulu JDK 21 更省心:推荐下载官方 MSI 包(如 zulu21.36.21-ca-jdk21.0.4-win_x64.msi),安装时勿勾选“Add to PATH”,手动配置 JAVA_HOME 指向安装目录(如 C:Program FilesZuluzulu-21),并在 Path 中添加 %JAVA_HOME%in,删除其他 JDK 路径,重启终端后执行 java -version、javac -version 和 where java 验证一致性。

Windows 11 上安装 Zulu JDK 21 比 Oracle JDK 更省心,它开箱即用、完全免费商用、无许可限制,且默认不往系统 PATH 里硬塞带空格的路径——这是很多构建失败的根源。
下载与安装:选对包,一步到位
Zulu JDK 21 提供多种格式,Windows 11 推荐直接使用 MSI 安装器(如 zulu21.36.21-ca-jdk21.0.4-win_x64.msi),理由很实在:
- 自动注册文件关联、支持系统级卸载,比 ZIP 包更规范
- 安装过程不强制勾选“Add to PATH”,避免路径含空格引发 Maven/Gradle 解析错误
- 来自 Azul 官方,无第三方捆绑、无广告、无精简删减(
jmods目录完整,jlink可用) - 下载地址认准:https://www.php.cn/link/6f497db742b82253d9cf8c89073da954,选择 “Zulu” → “JDK” → “Java 21” → “Windows x64 MSI”
JAVA_HOME 配置:必须手动设,不能依赖安装器
即使用了 MSI,也不要依赖它自动配 PATH。正确做法是手动设置两个环境变量:
- 新建系统变量 JAVA_HOME,值为 JDK 安装目录(例如:
C:Program FilesZuluzulu-21)——注意不带in - 编辑系统变量 Path,新增一项:
%JAVA_HOME%in - 删掉 PATH 中任何其他 JDK 的
bin路径(尤其旧版 Zulu、Temurin 或 Oracle JDK),防止版本冲突 - 配置完,关掉所有终端,重新打开 PowerShell 或 CMD 再验证
验证是否真生效:三步缺一不可
只跑 java -version 不够,得确认编译器、特性、路径三者一致:
-
java -version→ 看输出是否含21.0.x和Zulu字样 -
javac -version→ 确保编译器版本匹配,不是系统残留的旧版 javac -
where java和where javac→ 返回路径必须都指向%JAVA_HOME%in下的文件 - 额外建议运行:
java -Xshare:check(验证类数据共享是否启用)和java --virtual-thread-dump(快速试探虚拟线程支持)
与 Maven/IDE 协同要点
Zulu JDK 21 和 Maven 3.9+ 兼容良好,但需注意两处细节:
- Maven 自身不依赖 JAVA_HOME,但它调用的插件(如 compiler、surefire)会读取,所以确保
mvn -v显示的 Java 版本与java -version一致 - IntelliJ IDEA 或 VS Code 中,项目 SDK 需手动指定为
%JAVA_HOME%对应目录,不要用“自动检测”——它可能抓到 Windows Store 自带的 OpenJDK 17 - 若用 VS Code 的 Java Extension Pack,请在
settings.json中显式设置:"java.configuration.runtimes": [{ "name": "JavaSE-21", "path": "C:\Program Files\Zulu\zulu-21" }]

















