本文档详细说明如何在 Windows、Linux(基于 apt / dnf)和 macOS 三大主流操作系统上搭建 Java 开发环境,包括 JDK 安装、环境变量配置、命令行基础使用,以及如何通过 SDKMAN! 实现多版本 JDK 的统一管理。
一、核心概念说明
- JDK(Java Development Kit):Java 开发工具包,包含编译器(
javac)、运行时(JRE)、调试工具等,是开发 Java 程序的必备组件。 - JRE(Java Runtime Environment):仅用于运行 Java 程序,不含开发工具。开发必须安装 JDK。
- OpenJDK vs Oracle JDK:OpenJDK 是 Java SE 的开源参考实现,Oracle JDK 基于 OpenJDK 构建。自 Java 11 起,两者功能基本一致。推荐使用 OpenJDK(免费、开源、社区活跃)。
- LTS(Long-Term Support)版本:如 Java 8、11、17、21,获得长期安全更新,适合生产环境。
二、各操作系统 JDK 安装方式
2.1 Windows 系统
方法一:通过官方安装包(推荐初学者)
-
下载 JDK
- 访问 Adoptium (Eclipse Temurin) 或 Oracle JDK
- 选择 Windows x64 Installer (.msi)(如
OpenJDK 17 (LTS))
-
安装
- 双击
.msi文件,按向导完成安装(默认路径如C:\Program Files\Eclipse Adoptium\jdk-17.x.x-hotspot)
- 双击
-
配置环境变量
- 按
Win + R输入sysdm.cpl→ “高级” → “环境变量” - 在 系统变量 中:
- 新建
JAVA_HOME,值为 JDK 安装路径(如C:\Program Files\Eclipse Adoptium\jdk-17.0.12.7-hotspot) - 编辑
Path,添加%JAVA_HOME%\bin
- 新建
- 按
-
验证
java -version javac -version
方法二:使用 ZIP 包(便携式)
- 下载
.zip版本,解压到任意目录(如C:\tools\jdk-17) - 手动配置
JAVA_HOME和Path(同上)
2.2 Linux 系统
以下以 Ubuntu/Debian(apt) 和 Fedora/RHEL/CentOS(dnf) 为例
2.2.1 Ubuntu / Debian(使用 apt)
-
更新软件源
sudo apt update -
安装 OpenJDK(以 Java 17 为例)
sudo apt install openjdk-17-jdk -y -
验证安装路径
ls /usr/lib/jvm/ # 通常为 /usr/lib/jvm/java-17-openjdk-amd64 -
配置 JAVA_HOME(可选但不推荐)
# 获取默认 JDK 路径 sudo update-alternatives --config java # 通常路径为 /usr/lib/jvm/java-17-openjdk-amd64 # 将以下内容加入 ~/.bashrc 或 ~/.zshrc export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 export PATH=$JAVA_HOME/bin:$PATH -
生效并验证
source ~/.bashrc java -version javac -version
2.2.2 Fedora / RHEL / CentOS(使用 dnf 或 yum)
-
安装 OpenJDK(以 Java 17 为例)
# Fedora / RHEL 8+ / CentOS Stream sudo dnf install java-17-openjdk-devel -y # CentOS 7 / RHEL 7(使用 yum) sudo yum install java-17-openjdk-devel -y -
生效并验证
java -version javac -version
💡 提示:Linux 发行版通常通过
alternatives系统管理多版本 JDK,可通过sudo update-alternatives --config java切换。
2.3 macOS 系统
方法一:使用 Homebrew(推荐)
-
安装 Homebrew(若未安装)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" -
安装 OpenJDK
# 查看可用版本 brew search openjdk # 安装 Java 17(LTS) brew install openjdk@17 -
验证
java -version javac -version
三、使用 SDKMAN! 实现多版本 JDK 管理(强烈推荐!!!)
SDKMAN!(Software Development Kit Manager) 是一个用于管理 Java、Kotlin、Maven、Gradle 等 SDK 多版本的命令行工具,支持 Linux 和 macOS(Windows 需通过 WSL 使用)。
3.1 安装 SDKMAN!
Linux / macOS
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
✅ 验证安装:
sdk version
Windows(通过 WSL)
- 启用 WSL(推荐 Ubuntu)
- 在 WSL 终端中执行上述 Linux 安装命令
⚠️ 原生 Windows 不支持 SDKMAN!,建议使用 WSL 或手动管理多版本。
3.2 使用 SDKMAN! 管理 JDK
列出可用 JDK 发行版
sdk list java
输出示例:
Available Java Versions
================================================================================
Vendor | Use | Version | Dist | Status | Identifier
--------------------------------------------------------------------------------
Temurin | | 21.0.2 | adpt | | 21.0.2-tem
Temurin | | 17.0.10 | adpt | | 17.0.10-tem
Amazon | | 17.0.10 | amzn | | 17.0.10-amzn
GraalVM | | 21.0.2 | grl | | 21.0.2-grl
...
安装指定版本 JDK(以 Temurin 17 为例)
sdk install java 17.0.10-tem
设置默认版本(全局)
sdk default java 17.0.10-tem
临时切换版本(当前 shell 会话)
sdk use java 21.0.2-tem
查看当前使用版本
sdk current java
java -version
卸载版本
sdk uninstall java 11.0.20-tem
3.3 SDKMAN! 优势总结
| 特性 | 说明 |
|---|---|
| 多版本共存 | 可同时安装多个 JDK,自由切换 |
| 一键安装 | 自动下载、解压、配置 PATH |
| 支持多厂商 | Temurin、Amazon Corretto、GraalVM、Microsoft 等 |
| 跨平台 | Linux/macOS/WSL 统一体验 |
| 自动更新 | sdk upgrade 更新 SDKMAN! 本身,sdk install java 获取最新版本 |
四、开发工具(IDE)推荐
安装 JDK 后,建议搭配专业 IDE 提升开发效率:
| IDE | 特点 | 下载地址 |
|---|---|---|
| IntelliJ IDEA | 功能最强,智能提示、调试、框架支持极佳 | jetbrains.com/idea |
| VS Code + Extension Pack for Java | 轻量级,适合初学者或轻量项目 | marketplace.visualstudio.com |
| Eclipse | 开源老牌 IDE,插件丰富 | eclipse.org |
💡 IntelliJ IDEA Community Edition 免费且功能足够用于学习和中小型项目。
五、验证开发环境
创建一个简单 Java 程序测试环境是否正常:
// HelloWorld.java
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, Java World! 🌍");
}
}
编译并运行:
javac HelloWorld.java
java HelloWorld
预期输出:
Hello, Java World! 🌍
六、常见问题排查
| 问题 | 解决方案 |
|---|---|
java: command not found | 检查 PATH 是否包含 $JAVA_HOME/bin |
JAVA_HOME not set | 确保 JAVA_HOME 指向 JDK 根目录(非 bin 子目录) |
| 多版本冲突 | 使用 SDKMAN! 或系统 alternatives 统一管理 |
| macOS 提示“无法验证开发者” | 系统设置 → 隐私与安全性 → 允许运行 |
七、总结
- Windows:推荐使用
.msi安装包 + 手动配置环境变量。 - Linux:通过
apt(Debian/Ubuntu)或dnf(Fedora/RHEL)安装 OpenJDK。 - macOS:推荐 Homebrew 安装,或使用
.pkg包。 - 多版本管理:强烈推荐 SDKMAN!(Linux/macOS/WSL),实现 JDK 版本的灵活切换与统一管理。
搭建好环境后,即可进入 Java 语法学习阶段。保持 JDK 版本为 LTS(如 17 或 21),可获得最佳兼容性与长期支持。

被折叠的 条评论
为什么被折叠?



