第一部分：准备工作（所有系统通用）

在开始安装之前,请先完成以下步骤：

下载 JDK 安装包

你需要从官方网站下载 JDK，目前最主流的 JDK 是 OpenJDK 和 Oracle JDK。

• OpenJDK (推荐): 由开源社区维护，免费且功能与 Oracle JDK 几乎完全一致，大多数现代项目都推荐使用。
  • 下载地址: Eclipse Temurin (Adoptium) 或 Microsoft Build of OpenJDK，选择其中任何一个即可，它们都是高质量的 OpenJDK 发行版。
• Oracle JDK: 由 Oracle 官方提供，在旧版本中可能有一些商业限制（尤其是 JDK 8 之后），但现在也提供了免费版本，如果你需要 Oracle 的官方支持，可以选择它。
  • 下载地址: Oracle JDK 官网

下载时注意：

• 根据你的操作系统选择对应的版本（Windows, macOS, Linux）。
• 根据你的电脑架构选择 x64 (64位) 或 aarch64 (ARM64, 如 Apple M1/M2/M3 芯片)。
• 选择最新的 LTS (Long-Term Support, 长期支持) 版本，JDK 17 或 JDK 21，LTS 版本会获得更长时间的安全更新和 bug 修复，非常适合生产环境。

检查系统是否已安装 Java

为了避免安装冲突,可以先检查一下你的系统是否已经安装了 Java。

• Windows: 打开命令提示符 或 PowerShell，输入以下命令：

  
  （图片来源网络，侵删）

  java -version

  • 如果显示版本号,说明已安装，你可以记下版本号，决定是升级还是卸载旧版本。
  • 如果提示 'java' 不是内部或外部命令...，说明未安装或环境变量未配置，可以继续安装。

• macOS / Linux: 打开终端，输入：

  java -version

  macOS 自带一个较旧的 OpenJDK (通常是 JDK 6 或 8)，但版本过低，建议你自行安装一个新版本并配置环境变量来覆盖它。

第二部分：分步安装教程

Windows 系统安装 (以 Eclipse Temurin 为例)

1. 双击安装包 下载完 .msi 文件后，直接双击运行。

2. 同意许可协议 勾选 "I accept the terms in the License Agreement"，然后点击 "Next"。

   
   （图片来源网络，侵删）

3. 选择安装路径 (重要)

   • 系统会提供一个默认路径,C:\Program Files\Eclipse Adoptium\jdk-<version>。
   • 建议保持默认路径，这样便于后续管理，如果你想修改，请确保路径中不包含中文或空格。
   • 点击 "Next"。

4. 安装过程 安装程序会自动完成文件复制和配置，等待进度条走完，点击 "Close" 或 "Finish" 完成。

5. 配置环境变量 这是让系统能在任何地方识别 java 和 javac 命令的关键步骤。

   • 打开环境变量设置:
     • 按 Win + R 键，输入 sysdm.cpl，回车。
     • 在弹出的窗口中,切换到 "高级" 选项卡，点击 "环境变量..."。
   • 添加或修改 JAVA_HOME:
     • 在 "系统变量" 区域，点击 "新建"。
     • 变量名: JAVA_HOME
     • 变量值: 填写你刚才的 JDK 安装路径，C:\Program Files\Eclipse Adoptium\jdk-17.0.9.9-hotspot。
     • 点击 "确定"。
   • 编辑 Path 变量:
     • 在 "系统变量" 区域，找到并选中 Path 变量，点击 "编辑"。
     • 在弹出的窗口中,点击 "新建"，然后输入 %JAVA_HOME%\bin。
     • 确保这一项在列表的最上方，可以优先找到新版本的 JDK。
     • 点击 "确定" 保存所有更改。

6. 验证安装

   • 完全关闭并重新打开 命令提示符 或 PowerShell。
   • 输入以下命令进行验证：

     java -version
     javac -version
     echo %JAVA_HOME%

   • 如果都正确显示了版本信息和路径,说明安装和配置成功！

macOS 系统安装 (以 Homebrew 和 Eclipse Temurin 为例)

使用 Homebrew 是 macOS 上最简单、最推荐的管理软件的方式。

1. 安装 Homebrew (如果尚未安装) 打开终端，运行以下命令：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

   根据提示输入你的电脑密码即可。

2. 使用 Homebrew 安装 JDK 在终端中，输入以下命令安装 JDK 17 (LTS 版本):

   brew install --cask temurin17

   • --cask 参数用于安装图形界面的应用程序。
   • 你也可以安装其他版本,如 temurin21。

3. 配置环境变量 (可选但推荐) Homebrew 会自动将 JDK 的路径添加到 /usr/local/bin，通常无需手动配置 JAVA_HOME，但某些 IDE 或工具可能需要。

   • 查找安装路径: 在终端运行：

     /usr/libexec/java_home -V

     这会列出所有已安装的 JDK 版本及其路径。

     Matching Java Virtual Machines (2):
     17.0.9 (x86_64) "Eclipse Temurin" - "OpenJDK 17.0.9" /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
     1.8.0_362 (x86_64) "Oracle Corporation" - "Java SE 1.8.0_362" /Library/Java/JavaVirtualMachines/jdk1.8.0_362.jdk/Contents/Home

     记住你想要使用的版本（如 0.9）的路径。

   • 设置 JAVA_HOME: 为了让当前 Shell 会话使用这个版本，可以运行：

     export JAVA_HOME=$(/usr/libexec/java_home -v 17)

     注意：这个命令只在当前终端窗口有效，关闭后失效，如果希望永久生效，需要将其添加到你的 Shell 配置文件中（如 ~/.zshrc 或 ~/.bash_profile）。

4. 验证安装 在终端中输入：

   java -version
   javac -version
   echo $JAVA_HOME

   如果显示正确信息,则安装成功。

Linux (以 Ubuntu 为例) 系统安装

1. 更新软件包列表 打开终端，首先更新你的包管理器：

   sudo apt update

2. 安装 OpenJDK Ubuntu 的软件源中通常包含 OpenJDK，直接安装即可：

   # 安装 JDK 17 (LTS)
   sudo apt install openjdk-17-jdk
   # 如果需要其他版本，JDK 21
   # sudo apt install openjdk-21-jdk

   在安装过程中,系统会提示你确认，输入 Y 并回车。

3. 配置环境变量 apt 通常会自动配置好 java 和 javac 命令，但 JAVA_HOME 可能需要手动设置。

   • 查找 JDK 安装路径:

     # dpkg 是 Debian/Ubuntu 的包管理工具
     dpkg -L openjdk-17-jdk | grep bin/java

     输出结果会告诉你 java 可执行文件的位置，/usr/lib/jvm/java-17-openjdk-amd64/bin/java。JAVA_HOME 就是它的上一级目录：/usr/lib/jvm/java-17-openjdk-amd64。

   • 编辑环境变量文件:

     # 使用 nano 编辑器打开 profile 文件
     sudo nano /etc/environment

     在文件末尾添加以下内容（请根据你查找到的实际路径修改）：

     JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64"
     PATH="$JAVA_HOME/bin:$PATH"

     按 Ctrl + X，然后按 Y，最后按 Enter 保存并退出。

4. 使配置生效

   • 重启你的电脑，这是最简单的方法。
   • 或者,在当前终端运行 source /etc/environment，然后重新打开一个新的终端窗口。

5. 验证安装 在终端中输入：

   java -version
   javac -version
   echo $JAVA_HOME

   如果都显示正确,说明安装成功。

第三部分：常见问题与解决

问题 1：'java' 不是内部或外部命令... (Windows)

• 原因: Path 环境变量配置错误或未配置。
• 解决:
  1. 仔细检查 JAVA_HOME 变量值是否正确。
  2. 仔细检查 Path 变量中是否有 %JAVA_HOME%\bin 这一项。
  3. 确保 %JAVA_HOME%\bin 在 Path 列表的最上方。
  4. 务必完全关闭并重新打开 命令提示符。

问题 2：zsh: command not found: java (macOS)

• 原因: 终端使用的 Shell (如 zsh) 没有加载到正确的 JDK 路径。
• 解决:
  1. 运行 brew info temurin17 查看安装信息和推荐的配置命令。
  2. Homebrew 会提示你将以下内容添加到 ~/.zshrc 文件中：

     echo 'export PATH="/opt/homebrew/opt/openjdk/bin:$PATH"' >> ~/.zshrc

     (Apple Silicon Mac 路径可能不同，请以 brew info 输出为准)

  3. 运行 source ~/.zshrc 使配置生效，然后重新打开终端。

问题 3：如何切换不同版本的 JDK？

• Windows: 修改 JAVA_HOME 的值为你想切换的 JDK 路径，然后重启命令提示符。
• macOS / Linux: 使用 /usr/libexec/java_home -V 查看所有版本，然后通过设置 JAVA_HOME 来切换，在 macOS 的 .zshrc 中可以定义函数来快速切换：

  # 在 ~/.zshrc 中添加
  switch_java() {
      export JAVA_HOME=$(/usr/libexec/java_home -v $1)
      echo "Switched to Java $1"
  }

  保存后,在终端运行 source ~/.zshrc，然后就可以用 switch_java 17 来切换到 JDK 17 了。

希望这份详细的教程能帮助你成功安装 JDK！祝你编程愉快！