推荐使用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版本。

配置系统级环境变量

右键“此电脑” → “属性” → 左侧“高级系统设置” → “环境变量”；

在“系统变量”区域点击“新建”：

变量名：JAVA_HOME；

outlook-microsoft

微软 Outlook 邮箱和日历管理工具（支持世纪互联版 Office 365）。用于查看、发送、搜索邮件，管理日历日程，创建会议，查询忙闲状态。注意：此功能仅支持世纪互联（21Vianet）版 Microsoft 365，使用 login.chinacloudapi.cn。

下载

变量值：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-16
OpenJDK 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等构建任务。