全平台 Java (JDK) 安装与环境配置保姆级教程

1223 字

6 分钟

全平台 Java (JDK) 安装与环境配置保姆级教程

技术教程

Java

/

JDK

/

开发环境

/

教程

想要开始学习 Java 开发，或者运行 Minecraft 服务器？第一步就是安装 JDK (Java Development Kit)。本文将手把手教你在不同系统上完美安装 Java。

1. 版本选择与下载#

Java 版本众多，对于初学者或新项目，我们强烈建议选择 LTS (长期支持版)。

JDK 17 LTS：目前企业应用最广泛的版本，稳定且生态成熟。（推荐）
JDK 21 LTS：最新的长期支持版，包含虚拟线程等新特性。
JDK 8：老古董，除非维护旧项目，否则不推荐安装。

下载地址 (Adoptium Eclipse Temurin)#

为了避免 Oracle JDK 的协议授权问题，我们推荐使用开源免费的 Eclipse Temurin 版本。

访问 Adoptium 官网，网站会自动识别你的系统，点击 Latest LTS Release 下载即可。

NOTE
注意：如果你在中国大陆，下载速度慢可以使用清华大学开源镜像站加速下载。

2. Windows 系统安装#

Windows 用户最容易卡在环境变量配置上，请仔细阅读以下步骤。

🥪 方式一：安装包自动配置（小白推荐）#

现在的安装包已经非常智能，可以自动帮你处理大部分工作。

下载 .msi 格式的安装包。
双击运行，点击 Next。
关键步骤：在 “Custom Setup” 界面，点击 “Set JAVA_HOME variable” 左侧的红色叉号，选择 “Will be installed on local hard drive”。
- 如果不显示此选项，请注意看是否有 “Add to PATH” 的勾选框，务必勾选！
一路点击 Next 直到安装完成。

🍞 方式二：手动配置环境变量（硬核必修）#

如果你发现命令无法运行，或者使用解压版（.zip）安装，必须手动配置。

复制路径：找到你的 JDK 安装目录，例如 C:\Program Files\Eclipse Adoptium\jdk-17.0.8.7，复制这个路径。
打开设置：右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量。
新建 JAVA_HOME：
- 在下方的 “系统变量” 区域，点击 “新建”。
- 变量名：JAVA_HOME
- 变量值：粘贴刚才复制的路径（例如 C:\Program Files\Eclipse Adoptium\jdk-17.0.8.7）。
修改 Path：
- 在 “系统变量” 中找到 Path，双击打开。
- 点击 “新建”，输入 %JAVA_HOME%\bin。
- 点击 “上移”，建议将其移动到列表的最上方。
连续点击确定保存所有窗口。

3. macOS 系统安装#

Mac 用户相对幸福很多，既可以使用安装包，也可以使用命令行。

🍎 方式一：PKG 安装包（简单）#

下载 .pkg 格式的安装包。
双击运行，一路点击“继续”直到安装完成。
Mac 通常会自动配置好路径。

🍺 方式二：Homebrew 安装（开发者推荐）#

如果你安装了 Homebrew，这是管理 Java 版本的最优雅方式。

打开终端（Terminal），搜索并安装 JDK 17：
Terminal window
```
1
brew install openjdk@17
```
关键步骤：Homebrew 安装的 JDK 需要手动建立软连接才能被系统识别。执行安装完成后终端提示的命令（类似如下）：
Terminal window
```
1
sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk
```
配置环境变量（如果不生效）：编辑你的配置文件（.zshrc 或 .bash_profile），加入：
Terminal window
```
1
export JAVA_HOME=$(/usr/libexec/java_home)
```

4. Linux 系统安装 (Ubuntu/CentOS)#

Linux 服务器环境通常使用包管理器安装。

🐧 Ubuntu / Debian#

1
# 更新软件源
2
sudo apt update
3

4
# 安装 JDK 17
5
sudo apt install openjdk-17-jdk
6

7
# 验证安装
8
java -version

🐂 CentOS / RHEL#

1
# 安装 JDK 17
2
sudo yum install java-17-openjdk-devel
3

4
# 验证安装
5
java -version

5. 验证安装结果#

无论你使用的是哪个系统，安装完成后都需要验证是否成功。

打开终端（Windows 下是 CMD 或 PowerShell），输入以下命令：

1
java -version

成功标志：屏幕上显示了类似下面的版本信息，且没有报错：

1
openjdk version "17.0.8.1" 2023-08-24
2
OpenJDK Runtime Environment Temurin-17.0.8.1+1 (build 17.0.8.1+1)
3
OpenJDK 64-Bit Server VM Temurin-17.0.8.1+1 (build 17.0.8.1+1, mixed mode, sharing)

WARNING
如果提示 'java' 不是内部或外部命令...，说明环境变量配置失败，请回到 步骤 2 仔细检查 Path 变量设置。

6. 写下你的第一行代码#

仪式感是必须的！让我们运行 Java 版的 Hello World。

新建一个文件名为 Hello.java（注意后缀是 .java，文件名首字母大写）。
用记事本或 VS Code 打开，输入以下代码：

1
public class Hello {
2
    public static void main(String[] args) {
3
        System.out.println("Hello, Java World!");
4
    }
5
}

1
javac Hello.java

如果没报错，目录下会多出一个 Hello.class 文件。 4. 运行代码：

1
java Hello

如果你看到了 Hello, Java World! 的输出，恭喜你，Java 开发环境已经完美搭建！🚀

7. (进阶) 多版本管理#

如果你需要在 JDK 8、11、17 之间反复横跳，建议使用版本管理工具，而不是手动改环境变量。

Windows: 推荐使用 Scoop。
macOS / Linux: 强烈推荐 SDKMAN!。

1
# SDKMAN 使用示例
2
sdk list java       # 列出所有可用版本
3
sdk install java 17.0.8-tem  # 安装 Temurin 17
4
sdk use java 17.0.8-tem      # 切换到该版本

全平台 Java (JDK) 安装与环境配置保姆级教程

https://blog.obve.cn/posts/48522/

作者

Alec

发布于

2026-01-04

许可协议

CC BY-NC-SA 4.0

本地部署 DeepSeek R1 保姆级教程

Ollama 云模型部署

1

1. 版本选择与下载

下载地址 (Adoptium Eclipse Temurin)

🍺 方式二：Homebrew 安装（开发者推荐）

4

4. Linux 系统安装 (Ubuntu/CentOS)