JDK 与 Maven 安装准备

Forge Admin 后端需要 JDK 17 和 Maven 3.8+。以下是各平台的安装步骤。

JDK 17 安装

macOS

# 使用 Homebrew 安装
brew install openjdk@17

# 配置环境变量（添加到 ~/.zshrc）
echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 17)' >> ~/.zshrc
echo 'export PATH="$JAVA_HOME/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Windows

1. 下载 OpenJDK 17 安装包
2. 运行安装程序，选择"添加到 PATH"
3. 设置环境变量 JAVA_HOME 指向安装目录（如 C:\Program Files\Eclipse Adoptium\jdk-17.0.0.35-hotspot\）

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install openjdk-17-jdk

# 验证安装路径
readlink -f $(which java)
# 通常为 /usr/lib/jvm/java-17-openjdk-amd64

Maven 安装

macOS

# 使用 Homebrew 安装
brew install maven

Windows

1. 下载 Maven 压缩包
2. 解压到目标目录（如 C:\tools\apache-maven-3.9.x）
3. 添加到系统 PATH 环境变量

Linux

sudo apt install maven

验证安装

# 验证 JDK
java -version
# 期望输出: openjdk version "17.0.x" ...

# 验证 Maven
mvn -version
# 期望输出: Apache Maven 3.9.x
# 注意检查输出中的 Java version 是否为 17

可选：配置 Maven 国内镜像

如果你在国内，建议配置 Maven 阿里云镜像加速下载。编辑 ~/.m2/settings.xml：

<settings>
  <mirrors>
    <mirror>
      <id>aliyun</id>
      <mirrorOf>central</mirrorOf>
      <name>Aliyun Maven</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
  </mirrors>
</settings>