Java 中文文档

Appearance

JDK 安装与环境变量 ​

概述 ​

JDK（Java Development Kit）是 Java 开发工具包，包含编译器 javac、运行时 java 以及标准库等。要编写和运行 Java 程序，必须先安装 JDK 并正确配置环境变量。配置 JAVA_HOME 和 PATH 后，命令行即可使用 javac、java 等命令，许多 IDE 和构建工具也会依赖 JAVA_HOME 定位 JDK。

说明

JRE（Java Runtime Environment）仅包含运行环境；学习与开发请直接安装 JDK。

选择 JDK 版本 ​

类型说明
LTS（长期支持）推荐 JDK 17 或 JDK 21，企业与教程常用，免费长期更新。
Oracle JDK官方发行版，商业使用需留意许可；个人学习通常可用。
OpenJDK / 发行版Eclipse Temurin、Adoptium、Amazon Corretto、Azul Zulu 等，多为免费且兼容标准。

提示

本系列示例以 JDK 17 或 JDK 21 为基准；若使用 JDK 8，文中会注明差异。

Windows 安装与配置 ​

步骤 1：下载并安装 JDK ​

  1. 打开 Eclipse Temurin 或 Oracle JDK，选择 Windows x64 安装包（如 .msi）。
  2. 运行安装程序，按提示完成安装，记下安装路径（例如 C:\Program Files\Eclipse Adoptium\jdk-17.0.x-hotspot）。

步骤 2：配置环境变量 ​

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
  2. 在「系统变量」中新建：
    • 变量名：JAVA_HOME
    • 变量值：JDK 安装目录，如 C:\Program Files\Eclipse Adoptium\jdk-17.0.x-hotspot（不要带 \bin）。
  3. 编辑「系统变量」中的 Path，新建一项：%JAVA_HOME%\bin。
  4. 确定保存后，重新打开命令提示符或 PowerShell。

步骤 3：验证 ​

bash
java -version
javac -version

应分别显示运行时与编译器版本，且版本号一致。

macOS 安装与配置 ​

方式一：官方安装包（推荐新手） ​

  1. 从 Eclipse Temurin 或 Oracle 下载 macOS 的 .pkg 安装包。
  2. 安装后 JDK 通常在 /Library/Java/JavaVirtualMachines/ 下，例如：
    • Temurin 17：/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home

方式二：Homebrew ​

若已安装 Homebrew，可用以下命令安装：

bash
# 安装 OpenJDK 17（Eclipse Temurin）
brew install openjdk@17

安装后按提示将 JDK 加入 PATH；或手动设置（见下方「配置环境变量」）。

配置环境变量（macOS / Linux 通用思路） ​

编辑当前用户的 shell 配置文件（如 ~/.zshrc 或 ~/.bash_profile），添加：

bash
# 将路径改为你本机实际 JDK 目录
export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
export PATH="$JAVA_HOME/bin:$PATH"

保存后执行 source ~/.zshrc（或对应配置文件），使配置生效。

Linux 安装与配置 ​

使用包管理器（示例：Ubuntu/Debian） ​

bash
# 更新包列表后安装 OpenJDK 17
sudo apt update
sudo apt install openjdk-17-jdk

安装后 JDK 通常位于 /usr/lib/jvm/java-17-openjdk-amd64（路径因发行版略有差异）。

配置环境变量 ​

在 ~/.bashrc 或 ~/.profile 中追加：

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

执行 source ~/.bashrc 后生效。

验证安装是否成功 ​

在终端或命令提示符中依次执行：

bash
# 查看运行时版本
java -version

示例输出（格式因发行版而异）：

text
openjdk version "17.0.x" ...
OpenJDK Runtime Environment Temurin-17.x ...
bash
# 查看编译器版本
javac -version

应显示与 java -version 对应的 JDK 版本。

bash
# 确认 JAVA_HOME（Windows 用 set JAVA_HOME）
echo $JAVA_HOME

应输出你配置的 JDK 根目录路径。

注意

若 java 有输出而 javac 未找到，多半只安装了 JRE 或 PATH 未包含 %JAVA_HOME%\bin（或 $JAVA_HOME/bin）。请确认安装的是 JDK 并正确设置 JAVA_HOME 和 PATH。

注意事项 ​

  • JAVA_HOME 必须指向 JDK 的根目录（即包含 bin、lib 等文件夹的目录），不要指向 bin。
  • 修改环境变量后，需要重新打开终端或命令提示符，否则可能仍使用旧配置。
  • 若系统中有多个 JDK，确保 PATH 中优先出现当前要用的 JDK 的 bin 目录。
  • 使用 IDE 时，在项目或全局设置中指定 JDK 路径，通常与 JAVA_HOME 一致即可。

提示

配置完成后，可继续学习第一个 Java 程序，用 javac 和 java 在命令行中编译运行代码。

相关链接 ​

基于 VitePress 构建

Copyright © 2026 Java 中文文档