Java 环境配置详细教程

最推荐组合：Temurin 21（免费、社区活跃、跨平台一致性最好）

二、Windows 系统安装与配置（最详细步骤）

步骤 1：下载

1. 打开 https://adoptium.net/
2. 选择 JDK 21（或 17）
3. Operating System → Windows
   Architecture → x64
   Package Type → JDK
   点击 Latest release 下载 .msi 或 .zip

推荐下载 .msi 安装包（自动配置环境变量更方便）

步骤 2：安装

• 双击 .msi 文件 → Next → 一直默认 → 安装完成
• 安装路径默认：C:\Program Files\Eclipse Adoptium\jdk-21.x.x.x-hotspot

步骤 3：配置环境变量（最关键步骤）

方式一：图形界面（推荐新手）

1. 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
2. 在系统变量中：
   • 新建 → 变量名：JAVA_HOME
     变量值：C:\Program Files\Eclipse Adoptium\jdk-21.x.x.x-hotspot（你的实际路径）
   • 找到 Path → 编辑 → 新建 → 输入 %JAVA_HOME%\bin
3. 点击确定全部保存

方式二：命令行一键设置（管理员 PowerShell）

# 假设安装路径是 C:\Program Files\Eclipse Adoptium\jdk-21.0.2.13-hotspot
$jdkPath = "C:\Program Files\Eclipse Adoptium\jdk-21.0.2.13-hotspot"
[Environment]::SetEnvironmentVariable("JAVA_HOME",$jdkPath,"Machine")
$oldPath = [Environment]::GetEnvironmentVariable("Path","Machine")
$newPath = "$oldPath;$jdkPath\bin"
[Environment]::SetEnvironmentVariable("Path",$newPath,"Machine")

步骤 4：验证安装成功

打开 cmd 或 PowerShell，输入以下命令：

java -version
javac -version

正确输出示例（Temurin 21）：

openjdk version "21.0.2" 2024-01-16 LTS OpenJDK Runtime Environment Temurin-21.0.2+13 (build 21.0.2+13-LTS) OpenJDK 64-Bit Server VM Temurin-21.0.2+13 (build 21.0.2+13-LTS, mixed mode, sharing)

三、macOS 配置（Apple Silicon / Intel 通用）

最推荐方式：使用 Homebrew（主流）

（可选）手动设置 JAVA_ HOME

# 编辑 ~/.zshrc 或 ~/.zprofile
echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 21)' >> ~/.zshrc
source ~/.zshrc

验证

java -version

Homebrew 会自动把 Java 加到 PATH，无需手动配置 JAVA_ HOME（但建议配置）

安装 Temurin 21

brew install --cask temurin@21

安装 Homebrew（如果没有）

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

其他方式

• 官网下载 .pkg 双击安装
• SDKMAN!（多版本管理神器，见下文）

四、Linux（Ubuntu/Debian）配置

# 1. 安装 Adoptium Temurin 21（官方源方式）
sudo apt update
sudo apt install -y wget apt-transport-https gnupg
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /etc/apt/trusted.gpg.d/adoptium.asc
echo "deb https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
sudo apt update
sudo apt install temurin-21-jdk

# 2. 设置默认 Java 版本（多版本共存时）
sudo update-alternatives --config java
sudo update-alternatives --config javac

# 3. 设置 JAVA_HOME
echo 'export JAVA_HOME=/usr/lib/jvm/temurin-21-jdk-amd64' >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

五、多版本共存管理（强烈推荐）

当你需要同时使用 Java 8 / 11 / 17 / 21 / 23 时，使用以下工具：

1. jEnv（macOS/Linux 常用）

SDKMAN!（最推荐，全平台）

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
# 安装各种版本
sdk install java 21.0.2-tem
sdk install java 17.0.10-tem
sdk install java 11.0.22-tem
# 切换版本
sdk use java 21.0.2-tem

六、常见问题 & 快速排查（高频）

七、最终配置建议

• 日常开发：Temurin 21 + SDKMAN!
• 长期维护项目：Java 17 + SDKMAN!
• 性能极致追求：GraalVM 21（Native Image）
• 学习/新手：直接用 IntelliJ IDEA 社区版自带 JDK（内置 Temurin）

配置好后，建议立即创建一个 HelloWorld 项目验证：

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

编译运行：

javac Hello.java
java Hello

如果看到 Hello Java 21.x.x，恭喜你！Java 环境配置成功。