通过

安装 Microsoft Build of OpenJDK

本文介绍如何安装 Microsoft Build of OpenJDK。 要获取本文中提及的文件，请参阅下载 Microsoft Build of OpenJDK。

ZIP 和 TAR.GZ 包

对于 WindowsLinux 和 macOS，我们生成 ZIP （Windows） 和 TAR。GZ （Linux/macOS） 包。 要安装，请将其中一个包解压缩到你选择的文件夹中，然后将 JAVA_HOME 环境变量设置为该文件夹。

或者，您可以使用适用于您选择的操作系统的原生安装程序，如下一节所述。

本机安装程序

因此 Windows，我们将生成具有图形界面的 EXE 安装程序。 对于 macOS，我们将生成具有类似功能的 PKG 安装程序。 这些安装程序会自动将在你的PATH中使 JDK（Java 开发工具包）工具可用。

对于 Linux，我们将生成用于 apt 和 rpm 的 DEB 和 RPM 包。

下列各部分提供了这些安装程序的说明。

安装于 Windows

若要在任何版本的计算机上安装 Windows，可以使用 EXE 安装程序或 ZIP 包。 在 Windows 10 或更高版本上，还可以从Windows终端使用。

注意

每个 JDK 版本一次只能使用一种安装方法（EXE、MSI 或 ZIP）。 如果以前使用一种方法（例如：MSI）安装了给定的 JDK LTS（长期支持）版本，并且想要使用其他方法（例如：EXE）更新它，必须先卸载现有的 JDK，然后才能继续新安装。

使用 EXE 在Windows上安装

EXE （Windows 可执行文件）既提供图形安装方法，也提供仅限控制台的安装方法。 如果双击安装程序文件，它将启动传统的 Windows 应用程序安装程序，你可以在其中按照屏幕上的说明进行作。

对于大规模部署，可以使用以下步骤在命令行上安装 EXE：

  1. 下载.exe文件。 有关详细信息，请参阅下载 Microsoft Build of OpenJDK。

  2. 从下表中选择要安装的功能：

    功能 / 特点 说明
    FeatureEnvironment 更新 PATH 环境变量。 （默认）
    FeatureJarFileRunWith 将 .jar 文件与 Java 应用程序相关联。 （默认）
    FeatureJavaHome 更新 JAVA_HOME 环境变量。
    FeatureOracleJavaSoft 更新注册表项 HKLM\SOFTWARE\JavaSoft\。

    注意

    可以使用 FeatureOracleJavaSoft 在卸载 Microsoft 的 OpenJDK 版本后，防止 Oracle Java 从 PATH 启动。 如果需要还原 Oracle 注册表项，请重新安装 Oracle Java。

  3. 从命令行运行 EXE 文件。 使用所选功能，如下例所示。

    .\<package>.exe /SILENT /SUPPRESSMSGBOXES /ALLUSERS /TASKS="FeatureEnvironment,FeatureJarFileRunWith" /DIR="C:\Program Files\Microsoft\"

    注意

    如果仅为当前用户安装，请使用标志 /CURRENTUSER 而不是 /ALLUSERS。

    若要取消安装的进度栏屏幕，请使用标志 /VERYSILENT 而不是 /SILENT。

    /DIR 标志是可选的。 如果省略，则根据安装模式使用默认安装 dir： /ALLUSERS 或 /CURRENTUSER。

通过旧版 MSI 安装 Windows ：

如果在 JDK 11、JDK 17 或 JDK 21 上遇到 EXE 安装程序的问题，则可以卸载 EXE 并使用旧版 MSI（Microsoft Installer）获取类似的图形和仅限控制台的安装方法。 如果双击安装程序文件，它将启动传统的 Windows 应用程序安装程序，你可以在其中按照屏幕上的说明进行作。

对于大规模部署，可以使用以下步骤在命令行上安装 MSI：

  1. 下载.msi文件。 有关详细信息，请参阅下载 Microsoft Build of OpenJDK。

  2. 在通过 EXE 安装Windows步骤 2 的表中，选择您要安装的功能

    注意

    FeatureMain 是 MSI 的唯一默认选项，指示安装程序执行核心安装

    可使用将某些功能组合在一起的可选参数，如下例所示：

    参数 功能
    INSTALLLEVEL=1 FeatureMain,FeatureEnvironment,FeatureJarFileRunWith

  3. 在 msiexec 目标工作站上运行命令。 使用所选功能，如下例所示。

    msiexec /i <package>.msi ADDLOCAL=FeatureMain,FeatureEnvironment,FeatureJarFileRunWith,FeatureJavaHome INSTALLDIR="c:\Program Files\Microsoft\" /quiet

    注意

    必须将 INSTALLDIR 与 FeatureMain 配合使用。

    本示例以静默方式安装 Microsoft 构建的 OpenJDK，更新 PATH，将 .jar 文件与 Java 应用程序相关联，并定义 JAVA_HOME。

在Windows上使用Windows包管理器（winget）进行安装

若要使用 Windows 包管理器进行安装，请先 安装 winget，然后打开 Windows 终端。

接下来，使用以下命令搜索 Microsoft Build of OpenJDK 包：

winget search Microsoft.OpenJDK

生成的输出类似于：

Name                           Id                    Version
--------------------------------------------------------------
Microsoft Build of OpenJDK 25  Microsoft.OpenJDK.25  25.0.1

现在可以通过引用Id并使用以下命令来安装该包：

winget install Microsoft.OpenJDK.25

此命令生成的输出结果类似于：

Found Microsoft Build of OpenJDK 25 [Microsoft.OpenJDK.25]
This application is licensed to you by its owner.
Microsoft is not responsible for, nor does it grant any licences to, third-party packages.
Downloading https://aka.ms/download-jdk/microsoft-jdk-25.0.1-windows-x64.msi
  ██████████████████████████████   160 MB /  160 MB
Successfully verified installer hash
Starting package install...
Successfully installed

在 macOS 上安装

macOS 包可以通过 Homebrew 获取，或者以独立下载的形式提供，格式为 PKG（macOS 安装包）或 TAR.GZ。

若要安装最新版本，请使用 Homebrew：

brew install --cask microsoft-openjdk

此命令生成类似于以下内容的输出：

==> Downloading https://aka.ms/download-jdk/microsoft-jdk-25.0.1-macos-x64.pkg
Already downloaded: /Users/foobar/Library/Caches/Homebrew/downloads/c3df619c6411aa15151d0306a6a0f9760ff7ab0b54d0b00daade382500369c81--microsoft-jdk-25.0.1-macos-x64.pkg
==> Installing Cask microsoft-openjdk
==> Running installer for microsoft-openjdk; your password may be necessary.
Package installers may write to any location; options such as `--appdir` are ignored.
Password:
installer: Package name is Microsoft Build of OpenJDK
installer: Installing at base path /
installer: The install was successful.
🍺  microsoft-openjdk was successfully installed!

注意

包 microsoft-openjdk 指向最新版 Microsoft Build of OpenJDK。

若要安装其他主要版本，请使用 Homebrew：

brew install --cask microsoft-openjdk@11
# OR
brew install --cask microsoft-openjdk@17
# OR
brew install --cask microsoft-openjdk@21
# OR
brew install --cask microsoft-openjdk@25

要在 macOS 上使用 TAR.GZ 包进行安装，请将文件解压缩到您需要的位置。 JDK 位于 <location>/jdk-<version>/Contents/Home.

要使用 PKG 安装程序进行安装，请打开安装程序并按照说明进行操作。 默认情况下，JDK 安装在 /Library/Java/JavaVirtualMachines/microsoft-25.jdk/Contents/Home.

在 macOS 上卸载

若要卸载通过 Homebrew 或 PKG 安装的 OpenJDK 的Microsoft版本，请使用以下命令：

sudo rm -rf /Library/Java/JavaVirtualMachines/microsoft-25.jdk
sudo pkgutil --forget com.microsoft.25.jdk

要卸载使用 TAR.GZ 文件安装的软件包，请删除安装文件夹。

在 Ubuntu 上安装

若要在 Ubuntu 18.04、20.04、22.04 和 24.04 LTS 版本上安装，请打开终端并运行以下命令：

# Valid values are only '18.04', '20.04', '22.04', and '24.04'
# For other versions of Ubuntu, please use the tar.gz package
ubuntu_release=`lsb_release -rs`
wget https://packages.microsoft.com/config/ubuntu/${ubuntu_release}/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

添加存储库后，运行以下命令安装 Microsoft Build of OpenJDK：

sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install msopenjdk-25

注意

可能需要更新默认的 JDK 选择。 有关详细信息，请参阅 此处。

在 Debian 上安装

Debian 10-12

警告

截至2024年7月， 对德比安10 的正式支持已经结束。 截至 2024 年 7 月的所有已发布 JDK 仍可用，但不会收到持续更新或支持。

要在 Debian 10-12 上安装，请打开终端并运行以下命令：

sudo apt update
sudo apt install wget lsb-release -y
wget https://packages.microsoft.com/config/debian/$(lsb_release -rs)/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

添加存储库后，运行以下命令：

sudo apt update
sudo apt install msopenjdk-25

注意

可能需要更新默认的 JDK 选择。 有关详细信息，请参阅 此处。

Debian 9

警告

截至2024年7月， 德比安9 号的官方支持已经结束。 截至 2024 年 7 月的所有已发布 JDK 仍可用，但不会收到持续更新或支持。

要在 Debian 9 上安装，请打开终端并运行以下命令：

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/
wget -q https://packages.microsoft.com/config/debian/9/prod.list -O /etc/apt/sources.list.d/microsoft-prod.list

添加存储库后，运行以下命令：

sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install msopenjdk-25

注意

可能需要更新默认的 JDK 选择。 有关详细信息，请参阅 此处。

在 SUSE 上安装

openSUSE 15

若要在 openSUSE 15 上安装，请打开终端并运行以下命令：

sudo rpm -Uvh https://packages.microsoft.com/config/opensuse/15/packages-microsoft-prod.rpm
sudo zypper update # Note:  This will prompt you to set the desired trust level for the Microsoft repository and package signing key
sudo zypper install msopenjdk-25

SLES 15

若要在 SLES（SUSE Linux Enterprise Server）15 上安装，请打开终端并运行以下命令：

sudo rpm -Uvh https://packages.microsoft.com/config/sles/15/packages-microsoft-prod.rpm
sudo zypper update # Note:  This will prompt you to set the desired trust level for the Microsoft repository and package signing key
sudo zypper install msopenjdk-25

在 CentOS 7 上安装 (RPM)

要在 CentOS 7 上安装，请打开终端并运行以下命令：

sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
sudo yum install msopenjdk-25

注意

与 msopenjdk-25 相关的 RPM 包可能不会自动更新到最新的次要版本。 若要检查可用版本，请运行 yum -v list msopenjdk-25。 然后，运行 yum install msopenjdk-25-<version> 以强制更新指定版本。 示例： yum install msopenjdk-25-25.0.1-1

安装在 Alpine 的 (TAR.GZ)

若要在 Alpine 上安装，请下载适用于 tar.gz 的 Alpine 包（参见 下载 页面），并将其解压缩到所需位置。

注意

Alpine 仅支持 JDK 11 和 JDK 17。 我们不支持 Alpine JDK 21 及更高版本。

更改 Linux 上的默认 JDK

如果系统上安装了多个版本的 OpenJDK，请使用以下命令将 Microsoft Build of OpenJDK 设置为默认版本：

对于 Debian/Ubuntu：

sudo update-java-alternatives --set msopenjdk-25-amd64

对于 CentOS，可以使用 alternatives 命令来管理 Java 版本。

提供有关 Microsoft Build of OpenJDK 的反馈

向我们发送你的评论、想法和意见，帮助我们改进 Microsoft Build of OpenJDK。 请访问 GitHub 上的 OpenJDK 讨论页面，向我们发送反馈。

Java 和 OpenJDK 是 Oracle 和/或其附属机构的商标或注册商标。

  • Last updated on