使用终端

环境准备

1. 安装 JDK

Windows：
- 从 JDK 选择选择并下载 JDK
- 按照提示完成安装
- 配置环境变量
- 验证安装：
  1. 按 Win + R，输入 cmd 打开终端
  2. 输入 java -version
  3. 如果看到类似下面的输出，说明安装成功：
    java version "1.8.0_301" Java(TM) SE Runtime Environment (build 1.8.0_301-b09) Java HotSpot(TM) 64-Bit Server VM (build 25.301-b09, mixed mode)

Linux：

# Ubuntu/Debian系统
sudo apt update                    # 更新软件源
sudo apt install openjdk-8-jdk     # 安装 JDK 8

# CentOS 系统
sudo yum install java-1.8.0-openjdk-devel

# 验证安装
java -version

2. 安装构建工具

Maven：
- Windows：
  1. 访问 Maven 官网下载最新版本
  2. 下载 apache-maven-x.x.x-bin.zip（x.x.x 是版本号）
  3. 解压到合适位置（建议：C:\Program Files\Apache\maven）
  4. 配置环境变量：
    - 新建系统变量 MAVEN_HOME，值为 Maven 解压目录
    - 在 Path 变量末尾添加 ;%MAVEN_HOME%\bin
  5. 验证安装：
    Terminal window
    mvn -version
- Linux：
  Terminal window
```
# Ubuntu/Debian系统
sudo apt install maven

# CentOS 系统
sudo yum install maven

# 验证安装
mvn -version
```
Gradle（可选，如果项目使用 Gradle）：
- Windows：
  1. 访问 Gradle 官网下载最新版本
  2. 下载 gradle-x.x.x-bin.zip（x.x.x 是版本号）
  3. 解压到合适位置（建议：C:\Program Files\Gradle）
  4. 配置环境变量：
    - 新建系统变量 GRADLE_HOME，值为 Gradle 解压目录
    - 在 Path 变量末尾添加 ;%GRADLE_HOME%\bin
  5. 验证安装：
    Terminal window
    gradle -version
- Linux：
  Terminal window
```
# 使用 SDKMAN\! 安装（推荐）
curl -s "https://get.sdkman.io" | bash     # 安装 SDKMAN!
source "$HOME/.sdkman/bin/sdkman-init.sh"  # 初始化 SDKMAN!
sdk install gradle                         # 安装 Gradle

# 验证安装
gradle -version
```

Maven 构建步骤

1. 进入项目目录

# Windows 示例（如果项目在 D 盘的 minecraft文件夹）
D:
cd minecraft\plugins\MyPlugin

# Linux/macOS 示例
cd ~/minecraft/plugins/MyPlugin

# 验证是否在正确目录
dir                  # Windows
ls                   # Linux/macOS

确保你能看到 pom.xml 文件在当前目录。

2. 清理旧文件

mvn clean

这个命令会：

删除 target 目录及其所有内容
清理之前的构建结果
为新的构建做准备

3. 打包项目

# 方式1：常规打包（包含测试）
mvn package

# 方式2：跳过测试打包（更快）
mvn package -DskipTests

在打包过程中你会看到：

下载依赖的进度
编译代码的信息
运行测试的结果（如果没有跳过测试）
最后显示 BUILD SUCCESS 表示构建成功

4. 找到构建结果

# Windows
dir target
# 或
explorer target

# Linux/macOS
ls -l target

jar 文件通常命名为：项目名-版本号.jar

Gradle 构建步骤

1. 使用 Gradle Wrapper（推荐）

Wrapper 是项目专用的 Gradle 启动器，不需要本地安装 Gradle。

# Windows 系统
# 如果是第一次运行，可能需要下载 Gradle
gradlew.bat clean build

# Linux/macOS 系统
chmod +x ./gradlew              # 给予执行权限
./gradlew clean build          # 清理并构建

2. 使用全局 Gradle

如果项目没有 Wrapper 或者你想使用本地安装的 Gradle：

gradle clean build

3. 找到构建结果

# Windows
dir build\libs
# 或
explorer build\libs

# Linux/macOS
ls -l build/libs

常见问题解决

1. 依赖下载失败

如果看到类似 Could not resolve dependency 的错误：

配置镜像源：参考配置镜像源文档进行配置。

手动下载依赖：

# Maven 项目
mvn dependency:get -DgroupId=组 ID -DartifactId=项目 ID -Dversion=版本号
# 示例：下载 Paper API
mvn dependency:get -DgroupId=io.papermc.paper -DartifactId=paper-api -Dversion=1.19.4-R0.1-SNAPSHOT

# Gradle 项目
gradle --refresh-dependencies

2. 内存不足

如果看到 OutOfMemoryError 错误：

Maven 项目：

# Windows（在 cmd 中运行）
set MAVEN_OPTS=-Xmx512m
# 如果 512m 不够，可以设置更大，如-Xmx1024m

# Linux/macOS
export MAVEN_OPTS="-Xmx512m"

Gradle 项目：

# Windows
set GRADLE_OPTS=-Xmx512m

# Linux/macOS
export GRADLE_OPTS="-Xmx512m"

3. 编码问题

如果看到 编码GBK的不可映射字符 等错误：

Maven 项目：

# 在运行时指定编码
mvn -Dfile.encoding=UTF-8 clean package

Gradle 项目：在 build.gradle 中添加：

tasks.withType(JavaCompile) {
    options.encoding = 'UTF-8'
}

4. 其他常见错误

找不到 JAVA_HOME：
- 检查环境变量是否正确设置
- 重新打开终端让环境变量生效
找不到 mvn/gradle 命令：
- 检查环境变量是否正确设置
- 确认安装路径是否正确
- 尝试重新安装构建工具

构建失败但没有明显错误：

# Maven 项目，使用 debug 模式构建
mvn clean package -X

# Gradle 项目，使用 debug 模式构建
gradle clean build --debug