EnderRealm 技术文档

外观

Java 环境 ​

Java 是 EnderRealm 项目的主要编程语言。你需要安装两个版本的 JDK：21 和 17。

什么是 Java？ ​

Java 是一种广泛使用的编程语言，具有以下特点：

  • 跨平台：一次编写，到处运行
  • 面向对象：支持面向对象编程
  • 强类型：变量类型在编译时确定
  • 自动内存管理：垃圾回收机制

什么是 JDK？ ​

JDK（Java Development Kit）是 Java 开发工具包，包含：

  • JRE（Java Runtime Environment）：运行 Java 程序的环境
  • 编译器：将 Java 代码编译成字节码
  • 调试工具：帮助调试程序
  • 标准库：常用的类和接口

为什么需要两个版本？ ​

EnderRealm 项目需要两个 JDK 版本：

版本用途原因
JDK 21主要开发性能更好，支持最新特性
JDK 17构建 FloodgateLombok 兼容性要求

安装 JDK 21 ​

Windows ​

方法一：使用安装包（推荐） ​

  1. 访问 Adoptium 或 Azul
  2. 下载 JDK 21 安装包（Windows x64）
  3. 运行安装包，按提示完成安装
  4. 安装时勾选"Set JAVA_HOME variable"

方法二：使用包管理器 ​

powershell
# 使用 winget（Windows 10/11）
winget install EclipseAdoptium.Temurin.21.JDK

# 使用 scoop
scoop install temurin21-jdk

# 使用 chocolatey
choco install temurin21

macOS ​

方法一：使用安装包 ​

  1. 访问 Adoptium
  2. 下载 JDK 21 安装包（macOS x64 或 ARM64）
  3. 运行安装包，按提示完成安装

方法二：使用 Homebrew ​

bash
# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 JDK 21
brew install --cask temurin21

Linux ​

Ubuntu/Debian ​

bash
# 添加 Adoptium 仓库
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo apt-key add -
sudo add-apt-repository --yes https://packages.adoptium.net/artifactory/deb/

# 安装 JDK 21
sudo apt update
sudo apt install temurin-21-jdk

CentOS/RHEL/Fedora ​

bash
# 添加 Adoptium 仓库
sudo rpm --import https://packages.adoptium.net/artifactory/api/gpg/key/public
sudo dnf install https://packages.adoptium.net/artifactory/rpm/centos/8/x86_64/adoptium-rpm.repo

# 安装 JDK 21
sudo dnf install temurin-21-jdk

安装 JDK 17 ​

安装步骤与 JDK 21 类似，只需将版本号改为 17。

Windows（winget） ​

powershell
winget install EclipseAdoptium.Temurin.17.JDK

macOS（Homebrew） ​

bash
brew install --cask temurin17

Linux（Ubuntu/Debian） ​

bash
sudo apt install temurin-17-jdk

配置环境变量 ​

Windows ​

方法一：系统属性 ​

  1. 右键"此电脑" → "属性"
  2. 点击"高级系统设置"
  3. 点击"环境变量"
  4. 在"系统变量"中：
    • 新建 JAVA_HOME，值为 JDK 21 安装路径
    • 新建 JAVA_HOME_17，值为 JDK 17 安装路径
    • 编辑 Path，添加 %JAVA_HOME%\bin

方法二：PowerShell ​

powershell
# 设置 JAVA_HOME（永久生效，需重启终端）
[System.Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Program Files\Eclipse Adoptium\jdk-21.x.x-hotspot", "User")
[System.Environment]::SetEnvironmentVariable("JAVA_HOME_17", "C:\Program Files\Eclipse Adoptium\jdk-17.x.x-hotspot", "User")

# 添加到 PATH
$path = [System.Environment]::GetEnvironmentVariable("Path", "User")
[System.Environment]::SetEnvironmentVariable("Path", "$path;%JAVA_HOME%\bin", "User")

macOS/Linux ​

编辑 ~/.bashrc 或 ~/.zshrc：

bash
# JDK 21
export JAVA_HOME=/path/to/jdk-21
export PATH=$JAVA_HOME/bin:$PATH

# JDK 17
export JAVA_HOME_17=/path/to/jdk-17

使配置生效：

bash
source ~/.bashrc  # 或 source ~/.zshrc

验证安装 ​

打开终端，运行以下命令：

bash
# 验证 JDK 21
java -version

# 验证 JAVA_HOME
echo $JAVA_HOME        # macOS/Linux
echo $env:JAVA_HOME    # Windows PowerShell

# 验证 JDK 17
echo $JAVA_HOME_17     # macOS/Linux
echo $env:JAVA_HOME_17 # Windows PowerShell

应该看到类似输出：

openjdk version "21.x.x" 2024-xx-xx
OpenJDK Runtime Environment Temurin-21.x.x (build 21.x.x+x)
OpenJDK 64-Bit Server VM Temurin-21.x.x (build 21.x.x+x, mixed mode, sharing)

常见问题 ​

Q: 安装后 java -version 命令不生效？ ​

A: 可能是环境变量未正确配置。请检查：

  1. JAVA_HOME 是否设置正确
  2. %JAVA_HOME%\bin 是否添加到 PATH
  3. 是否重启了终端

Q: 如何切换 Java 版本？ ​

A: 可以使用以下工具管理多个 Java 版本：

Q: 为什么推荐 Adoptium/Temurin？ ​

A: Adoptium 是 Eclipse 基金会维护的 OpenJDK 发行版，具有以下优点：

  • 完全免费开源
  • 长期支持（LTS）
  • 经过充分测试
  • 广泛使用和验证

推荐学习资源 ​

下一步 ​

Java 环境安装完成后，让我们继续学习 Git 安装与配置。

© 2022-present EnderRealm. All rights reserved.