java 环境配置(详细教程)-程序员充电站

Java 环境配置详细教程（2025–2026 最新主流方式）

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

目前（2026年初）最推荐的 Java 版本组合

使用场景	强烈推荐版本	LTS 状态	备注与下载渠道
新项目 / 企业主流	Java 21	LTS（长期支持）	目前最推荐的长期稳定版本
兼容性要求极高	Java 17	LTS	仍然大量企业在用，生态最成熟
追求最新特性	Java 23 / 24（非LTS）	非LTS	短期实验、新语法尝鲜用
极老项目维护	Java 8 / 11	已过时/部分支持	尽量避免新项目使用

2026 年建议：
新项目直接用 Java 21（LTS + 虚拟线程 + 结构化并发 + 记录模式匹配等特性已非常成熟）

一、下载 JDK（2026 年推荐来源）

发行版	是否免费商用	推荐场景	官网下载链接（2026 年有效）
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/

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

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

步骤 1：下载

打开 https://adoptium.net/
选择JDK 21（或 17）
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：配置环境变量（最关键步骤）

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

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

方式二：命令行一键设置（管理员 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（2026 年主流）

安装 Homebrew（如果没有）

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

安装 Temurin 21
```
brewinstall--cask temurin@21
```
验证
```
java -version
```
Homebrew 会自动把 Java 加到 PATH，无需手动配置 JAVA_HOME（但建议配置）

（可选）手动设置 JAVA_HOME

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

其他方式

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

四、Linux（Ubuntu/Debian）配置

# 1. 安装 Adoptium Temurin 21（官方源方式）sudoaptupdatesudoaptinstall-ywgetapt-transport-https gnupgwget-qO - https://packages.adoptium.net/artifactory/api/gpg/key/public|sudotee/etc/apt/trusted.gpg.d/adoptium.ascecho"deb https://packages.adoptium.net/artifactory/deb$(lsb_release -cs)main"|sudotee/etc/apt/sources.list.d/adoptium.listsudoaptupdatesudoaptinstalltemurin-21-jdk# 2. 设置默认 Java 版本（多版本共存时）sudoupdate-alternatives --config javasudoupdate-alternatives --config javac# 3. 设置 JAVA_HOMEecho'export JAVA_HOME=/usr/lib/jvm/temurin-21-jdk-amd64'>>~/.bashrcecho'export PATH=$JAVA_HOME/bin:$PATH'>>~/.bashrcsource~/.bashrc

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

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

SDKMAN!（最推荐，全平台）

curl-s"https://get.sdkman.io"|bashsource"$HOME/.sdkman/bin/sdkman-init.sh"# 安装各种版本sdkinstalljava21.0.2-tem sdkinstalljava17.0.10-tem sdkinstalljava11.0.22-tem# 切换版本sdk use java21.0.2-tem

jEnv（macOS/Linux 常用）

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

问题	可能原因	解决方法
`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

七、2026 年推荐最终配置建议

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

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

publicclassHello{publicstaticvoidmain(String[]args){System.out.println("Hello Java "+System.getProperty("java.version"));}}

编译运行：

javac Hello.java java Hello

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

需要我帮你写某个具体版本的更详细步骤，或者 IDEA / VSCode / Eclipse 的 JDK 配置截图式教程，随时告诉我～

java 环境配置(详细教程)