推荐使用Microsoft Build of OpenJDK 17 ZIP包(如msopenjdk-17.0.11+9-windows-x64.zip),解压至无中文无空格路径(如D:\jdk\msopenjdk-17.0.11+9),配置JAVA_HOME指向该路径,并将%JAVA_HOME%\bin置于Path顶部,验证java -version与javac -version均显示含“Microsoft”的17.0.11版本即成功。

在Windows 11上为Java项目构建环境配置Microsoft Build of OpenJDK 17,需确保使用官方认证的、专为构建场景优化的JDK发行版,避免因JVM实现差异导致Maven/Gradle编译失败或CI流水线中断。
下载Microsoft Build of OpenJDK 17
打开浏览器,访问微软官方JDK下载页:https://www.php.cn/link/4901bb0ca66492709c3cf19d91f86538;
向下滚动至“Windows”区域,点击“Download JDK 17 (x64)”按钮(文件名形如 msopenjdk-17.0.11+9-windows-x64.zip);
【必须下载.zip格式,而非.msi】——Microsoft Build of OpenJDK不提供Windows安装程序(.msi),仅提供免安装ZIP包,解压即用,且该版本未捆绑JRE组件,精简可靠;
将ZIP包保存到路径明确、无中文、无空格的位置,例如:D:\jdk\msopenjdk-17.0.11+9(提前手动创建该目录)。
解压并验证JDK结构
右键ZIP文件 → 选择“全部提取” → 指定目标文件夹为刚才创建的 D:\jdk\msopenjdk-17.0.11+9 → 点击“提取”;
进入该目录,确认存在 bin、lib、conf 三个核心子目录;
双击运行 bin\java.exe,若弹出命令行窗口并立即退出,说明可执行文件完整——这是最轻量的可用性验证;
若双击无反应或报错“找不到vcruntime140.dll”,说明系统缺少Visual C++ 2015–2022运行库,需前往微软官网下载安装对应x64版本。
配置系统级环境变量
右键“此电脑” → “属性” → 左侧“高级系统设置” → “环境变量”;
在“系统变量”区域点击“新建”:
微软 Outlook 邮箱和日历管理工具(支持世纪互联版 Office 365)。用于查看、发送、搜索邮件,管理日历日程,创建会议,查询忙闲状态。注意:此功能仅支持世纪互联(21Vianet)版 Microsoft 365,使用 login.chinacloudapi.cn。
变量名:JAVA_HOME;
变量值:D:\jdk\msopenjdk-17.0.11+9(严格对应你解压的实际路径,末尾不加反斜杠);
再次点击“系统变量”中的 Path → “编辑” → “新建” → 输入:%JAVA_HOME%\bin;
【务必把这一行拖拽至Path列表顶部】——否则若系统中已存在其他JDK(如Adoptium或Oracle),cmd中执行java时仍会调用旧版本,导致构建行为不一致;
连续点击所有“确定”关闭窗口,完成配置。
命令行终端验证配置
按 Win + R → 输入 cmd → 回车,打开全新命令提示符;
输入:echo %JAVA_HOME% → 回车,确认输出路径与你设置的一致;
输入:java -version → 回车,应显示类似内容:
openjdk version "17.0.11" 2026-04-16OpenJDK Runtime Environment Microsoft-17.0.11+9 (build 17.0.11+9)OpenJDK 64-Bit Server VM Microsoft-17.0.11+9 (build 17.0.11+9, mixed mode, sharing);
输入:javac -version → 回车,输出应为 javac 17.0.11;
若两命令均正常返回且版本号含“Microsoft”,说明Microsoft Build of OpenJDK 17已就绪,可直接用于Maven clean compile、Gradle build等构建任务。

















