Java 环境配置详细教程 | 极客日志

Javajava

Java 环境配置详细教程

详细介绍 Windows、macOS 和 Linux 系统下的 Java 环境配置流程。内容包括 JDK 下载渠道推荐（如 Temurin）、各平台环境变量设置方法、多版本管理工具 SDKMAN 的使用以及常见问题的排查方案。建议新项目采用 Java 21 LTS 版本，并提供 Hello World 验证示例。

PhpPioneer发布于 2026/3/23更新于 2026/4/1824K 浏览

Java 环境配置详细教程

以下教程主要针对 Windows、macOS、Linux（Ubuntu/Debian/CentOS）三种主流操作系统，推荐当前的配置方式。

目前推荐的 Java 版本组合

使用场景	强烈推荐版本	LTS 状态	备注与下载渠道
新项目 / 企业主流	Java 21	LTS（长期支持）	目前最推荐的长期稳定版本

发行版	是否免费商用	推荐场景	官网下载链接
Temurin (Eclipse Adoptium)	完全免费商用	最推荐（稳定性高、更新快）	https://adoptium.net/
Oracle JDK	免费开发，商用需订阅	官方原版，需要登录	https://www.oracle.com/java/technologies/downloads/
Zulu (Azul)	完全免费商用	老项目兼容性好	https://www.azul.com/downloads/
Amazon Corretto	完全免费商用	AWS 用户首选	https://docs.aws.amazon.com/corretto/latest/corretto-21-ug/downloads-list.html
GraalVM	免费商用	需要 Native Image / Polyglot	https://www.graalvm.org/downloads/

# 假设安装路径是 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")

java -version
javac -version

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)

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

java -version

brew install --cask temurin@21

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

# 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

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

问题	可能原因	解决方法
`java` 命令未找到	Path 没加 bin 目录	检查环境变量 Path 是否包含 %JAVA_ HOME%\bin
`java -version` 显示旧版本	多个 JDK 并存，系统默认错	update-alternatives 或 sdk use
IDEA / VSCode 找不到 JDK	没配置 JAVA_ HOME 或 IDE 没刷新	IDE 设置 → SDK → Add JDK → 选择安装目录
运行时提示 UnsupportedClassVersionError	编译版本 > 运行版本	统一使用相同或更新的 JDK 运行
macOS ARM 芯片运行 x86 程序很慢	用了 x86 版 JDK	下载 aarch64 版 Temurin

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

javac Hello.java
java Hello

Java 环境配置详细教程

Java 环境配置详细教程

目前推荐的 Java 版本组合

一、下载 JDK（推荐来源）

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

步骤 1：下载

步骤 2：安装

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

步骤 4：验证安装成功

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

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

其他方式

四、Linux（Ubuntu/Debian）配置

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

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

七、最终配置建议

更多推荐文章

相关免费在线工具

Java 环境配置详细教程

Java 环境配置详细教程

目前推荐的 Java 版本组合

一、下载 JDK（推荐来源）

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

步骤 1：下载

步骤 2：安装

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

步骤 4：验证安装成功

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

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

其他方式

四、Linux（Ubuntu/Debian）配置

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

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

七、最终配置建议

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具