Java JDK 超详细安装与配置教程 – wiki大全

作者： /

Java JDK 超详细安装与配置教程

Java Development Kit (JDK) 是 Java 应用程序开发的核心。它包含了 Java 运行时环境（JRE）、Java 编译器（javac）、以及其他开发工具和库。本教程将带您详细了解如何在主流操作系统上安装和配置 JDK。

一、JDK 下载

首先，您需要从 Oracle 官方网站下载适合您操作系统的 JDK 版本。

  1. 访问 Oracle 官网： 打开浏览器，访问 Oracle JDK 下载页面：https://www.oracle.com/java/technologies/downloads/
  2. 选择版本： 根据您的需求选择一个 LTS (长期支持) 版本，例如 JDK 17 或 JDK 21。
  3. 选择操作系统： 在下载页面找到您的操作系统对应的下载包（例如 Windows x64 Installer, macOS x64 DMG Installer, Linux x64 Compressed Archive）。
  4. 接受许可协议： 在下载前，请务必阅读并接受 Oracle 的许可协议。
  5. 下载： 点击下载链接，获取安装包。

二、JDK 安装

安装过程根据操作系统有所不同。

1. Windows 系统

  1. 运行安装程序： 找到下载的 .exe 文件（例如 jdk-17_windows-x64_bin.exe），双击运行。
  2. 按照向导提示：
    • 点击 “Next”。
    • 您可以选择更改安装路径，但建议保持默认路径（例如 C:\Program Files\Java\jdk-17），以便于后续配置。点击 “Next”。
    • 等待安装完成。
    • 点击 “Close” 完成安装。

2. macOS 系统

  1. 运行安装程序： 找到下载的 .dmg 文件，双击打开。
  2. 运行安装包： 在弹出的窗口中，双击 JDK <version>.pkg 文件。
  3. 按照向导提示：
    • 点击 “继续” -> “安装”。
    • 输入您的管理员密码进行授权。
    • 等待安装完成。
    • 点击 “关闭”。

3. Linux 系统 (以 Tarball 为例)

对于 Linux 系统，通常下载的是 .tar.gz 压缩包。

  1. 创建安装目录： 打开终端，创建一个用于存放 JDK 的目录。通常建议放在 /usr/local/java 或 /opt/java。
    bash
    sudo mkdir -p /usr/local/java
  2. 解压 JDK： 将下载的 .tar.gz 文件解压到刚刚创建的目录。假设下载文件在 ~/Downloads/ 目录下，文件名为 jdk-17_linux-x64_bin.tar.gz。
    bash
    sudo tar -xzf ~/Downloads/jdk-17_linux-x64_bin.tar.gz -C /usr/local/java/
  3. 重命名目录 (可选但推荐)： 为了方便管理，可以重命名解压后的目录。
    bash
    sudo mv /usr/local/java/jdk-17.0.10 /usr/local/java/jdk-17 # 根据实际解压出来的文件夹名调整

三、JDK 环境变量配置

环境变量配置是使操作系统能够找到并使用 JDK 的关键步骤。

1. Windows 系统

  1. 打开系统属性：
    • 右键点击 “此电脑” (或 “我的电脑”) -> “属性”。
    • 点击 “高级系统设置”。
  2. 打开环境变量： 在 “系统属性” 窗口中，点击 “环境变量” 按钮。
  3. 配置 JAVA_HOME：
    • 在 “系统变量” 区域，点击 “新建…”。
    • 变量名：JAVA_HOME
    • 变量值：JDK 的安装路径（例如 C:\Program Files\Java\jdk-17）。
    • 点击 “确定”。
  4. 配置 Path 变量：
    • 在 “系统变量” 区域，找到并双击 Path 变量。
    • 点击 “新建”，然后添加 %JAVA_HOME%\bin。
    • 确保此条目在其他 Java 相关路径之前（如果存在）。
    • 点击 “确定” 关闭所有窗口。

2. macOS 系统

macOS 上的 JDK 安装通常会自动配置部分环境变量，但手动配置 JAVA_HOME 仍然是最佳实践。

  1. 打开终端。
  2. 编辑配置文件： 您可以使用 ~/.bash_profile, ~/.zshrc (macOS Catalina 及更高版本默认 shell) 或 ~/.profile 文件。
    bash
    # 如果使用zsh
    nano ~/.zshrc
    # 如果使用bash
    nano ~/.bash_profile
  3. 添加环境变量： 在文件末尾添加以下行。请根据您安装的 JDK 版本和路径进行调整。
    bash
    export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home # 默认安装路径，请根据实际情况调整
    export PATH=$JAVA_HOME/bin:$PATH

    • 注意： 对于通过 Oracle 安装程序安装的 JDK，JAVA_HOME 的路径通常为 /Library/Java/JavaVirtualMachines/jdk-<version>.jdk/Contents/Home。您可以通过运行 /usr/libexec/java_home 命令来获取当前系统默认 JDK 的路径。
  4. 保存并退出： Ctrl + O (写入)，Enter，Ctrl + X (退出)。
  5. 使配置生效：
    bash
    # 如果使用zsh
    source ~/.zshrc
    # 如果使用bash
    source ~/.bash_profile

3. Linux 系统

  1. 打开终端。
  2. 编辑配置文件： 您可以编辑 ~/.bashrc, ~/.profile 或 /etc/profile (全局配置)。推荐编辑 ~/.bashrc 或 ~/.profile。
    bash
    nano ~/.bashrc
  3. 添加环境变量： 在文件末尾添加以下行。请根据您的安装路径进行调整。
    bash
    export JAVA_HOME=/usr/local/java/jdk-17 # 根据您实际的安装路径调整
    export PATH=$JAVA_HOME/bin:$PATH
    export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

    • CLASSPATH 变量现在通常不再需要手动配置，但为了兼容性或特定旧项目，可以添加。. 表示当前目录。
  4. 保存并退出： Ctrl + O (写入)，Enter，Ctrl + X (退出)。
  5. 使配置生效：
    bash
    source ~/.bashrc
    如果您修改的是 /etc/profile，则需要重启或运行 source /etc/profile。

四、验证安装

安装和配置完成后，验证 JDK 是否正确安装。

  1. 打开新的终端或命令提示符。 (确保是新打开的，以便环境变量生效)
  2. 检查 Java 版本：
    bash
    java -version
    您应该看到类似以下输出，显示您安装的 JDK 版本：
    openjdk version "17.0.10" 2024-01-16 LTS
    OpenJDK Runtime Environment (build 17.0.10+7-LTS)
    OpenJDK 64-Bit Server VM (build 17.0.10+7-LTS, mixed mode, sharing)
  3. 检查 Java 编译器版本：
    bash
    javac -version
    您应该看到类似以下输出：
    javac 17.0.10
  4. 检查 JAVA_HOME 变量 (可选)：
    • Windows: echo %JAVA_HOME%
    • macOS/Linux: echo $JAVA_HOME
      这应该显示您配置的 JDK 安装路径。

如果以上命令都能正确显示版本信息和路径，恭喜您，Java JDK 已成功安装并配置完成！

五、常见问题与排查

  • 'java' is not recognized as an internal or external command (Windows) 或 java: command not found (Linux/macOS):
    • 这通常意味着 Path 环境变量没有正确配置，或者配置后没有在新终端中生效。
    • 检查 Path 变量中 %JAVA_HOME%\bin (Windows) 或 $JAVA_HOME/bin (Linux/macOS) 是否存在且正确。
    • 确保在新终端/命令提示符中执行验证命令。
  • 安装了多个 JDK 版本：
    • 确保您的 Path 变量中，您希望使用的 JDK 版本的 bin 目录排在其他 JDK 之前。
    • 在 Linux/macOS 上，可以使用 update-alternatives 命令来管理多个 Java 版本 (适用于通过包管理器安装的 OpenJDK)。
  • 环境变量不生效：
    • 确认您修改的是正确的配置文件 (.bashrc, .zshrc, .bash_profile)。
    • 在修改后，务必 source 配置文件或打开新的终端。
    • 对于全局配置 (/etc/profile)，可能需要重启系统才能完全生效。

通过遵循本教程的步骤，您将能够顺利地安装和配置 Java JDK，为您的 Java 开发之旅打下坚实的基础。

滚动至顶部