序言

本教程由「小荣的网络开发日志」实操整理编写，实操踩坑验证，内容真实可靠。

遇到操作问题可直接联系作者，转载需标注原文出处，禁止私自篡改商用。

承接网站、APP、小程序、各类脚本定制开发；

AI 编程教学、一对一项目全程陪跑，提供免费技术咨询。

联系方式：微信：rongyaolg 电话：18375295913

这篇适合谁

如果你准备做 Spring Boot 后端、Android 原生开发、企业系统，或者教程明确要求 Java / JDK，就需要安装 JDK。

如果你只是做网页、小程序、Python AI 脚本，不一定要装 Java。

JDK、JRE、Java 是什么关系

新手可以这样理解：

名词	含义
Java	编程语言
JDK	写 Java、编译 Java、运行 Java 项目需要的开发工具包
JRE	只负责运行 Java 程序的运行环境
JAVA_HOME	告诉系统 JDK 安装在哪里的环境变量

做开发要安装 JDK，不要只装 JRE。

选哪个版本

推荐新手选择 LTS 版本，也就是长期支持版本。

常见选择：

JDK 17：很多企业项目、老一点的 Spring Boot 教程仍然常用
JDK 21：较新的 LTS，适合新项目
JDK 25：更新的 LTS，如果你的工具链已经支持，也可以选择

如果你跟着课程或公司项目做，优先按项目要求来。没有明确要求时，安装 JDK 21 通常比较稳。

推荐下载入口：

Eclipse Temurin JDK：https://adoptium.net/temurin/releases

Windows 安装步骤

打开 Eclipse Temurin 下载页
Version 选择一个 LTS 版本，比如 21 或 17
Operating System 选择 Windows
Architecture 通常选择 x64
Package Type 选择 JDK
下载 .msi 安装包并运行
安装时如果看到设置环境变量的选项，勾选 JAVA_HOME 和 PATH

安装完成后打开新的 PowerShell：

java -version
javac -version

两个命令都能看到版本号，说明 JDK 基本可用。

Windows 手动配置 JAVA_HOME

如果 java -version 或 javac -version 找不到，需要手动配置。

打开开始菜单，搜索 环境变量
进入 编辑系统环境变量
点击 环境变量
在系统变量里新建：

变量名	示例值
JAVA_HOME	C:\Program Files\Eclipse Adoptium\jdk-21.x.x

找到系统变量里的 Path
新增：

%JAVA_HOME%\bin

保存后关闭所有终端，重新打开 PowerShell 验证：

echo $env:JAVA_HOME
java -version
javac -version

macOS 安装步骤

方式一：官网下载

打开 https://adoptium.net/temurin/releases
选择 macOS、你的芯片架构、JDK、LTS 版本
下载 .pkg 安装包
双击安装
打开终端验证：

java -version
javac -version

查看 JDK 安装位置：

/usr/libexec/java_home

方式二：Homebrew 安装

如果你已经安装 Homebrew，可以执行：

brew install --cask temurin
java -version
javac -version

macOS 配置 JAVA_HOME

如果需要手动配置，把下面内容加入你的 shell 配置文件。

zsh 用户通常编辑 ~/.zshrc：

export JAVA_HOME=$(/usr/libexec/java_home)
export PATH="$JAVA_HOME/bin:$PATH"

让配置生效：

source ~/.zshrc
echo $JAVA_HOME

Linux 安装步骤

Ubuntu / Debian 可以安装 OpenJDK：

sudo apt update
sudo apt install -y openjdk-21-jdk
java -version
javac -version

如果你的系统源没有 JDK 21，可以安装 JDK 17：

sudo apt install -y openjdk-17-jdk

Fedora：

sudo dnf install -y java-21-openjdk-devel

Arch Linux：

sudo pacman -S jdk-openjdk

Linux 配置 JAVA_HOME

先找到 Java 路径：

readlink -f $(which java)

常见路径类似：

/usr/lib/jvm/java-21-openjdk-amd64/bin/java

那么 JAVA_HOME 应该是去掉 /bin/java 后的目录：

/usr/lib/jvm/java-21-openjdk-amd64

编辑 ~/.bashrc 或 ~/.zshrc：

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

生效：

source ~/.bashrc
echo $JAVA_HOME

第一个 Java 程序

新建 Hello.java：

public class Hello {
  public static void main(String[] args) {
    System.out.println("Hello Java");
  }
}

编译：

javac Hello.java

运行：

java Hello

看到 Hello Java，说明 JDK 能正常编译和运行 Java 程序。

常见问题

java 可以用，但 javac 找不到

这通常说明你装的是 JRE，或者 PATH 没指到 JDK 的 bin 目录。

解决方式：

确认安装的是 JDK，不是 JRE
配置 JAVA_HOME
把 %JAVA_HOME%\bin 或 $JAVA_HOME/bin 加到 PATH
重启终端后再验证

JAVA_HOME 配了还是不生效

先检查终端是不是重新打开了。环境变量修改后，旧终端不会自动刷新。

Windows 检查：

echo $env:JAVA_HOME

macOS / Linux 检查：

echo $JAVA_HOME

我应该装 17、21 还是 25

看项目要求。课程写 17 就装 17，课程写 21 就装 21。

如果没有要求，新项目优先 JDK 21；如果你正在跟旧企业项目或老教程，JDK 17 兼容性通常更稳。

安装完成检查清单

java -version 能看到版本号
javac -version 能看到版本号
JAVA_HOME 能输出 JDK 目录
Hello.java 能编译
java Hello 能运行

这五项都通过，就可以继续学习 Java、Spring Boot 或 Android 开发了。

Java / JDK 安装教程：Windows / macOS / Linux 配好 JAVA_HOME

序言