NitWikit

外观

使用终端 ​

环境准备 ​

1. 安装 JDK ​

  1. Windows：

    • 从JDK 选择选择并下载 jdk
    • 按照提示完成安装
    • 配置环境变量
    • 验证安装：
      1. 按 Win + R，输入 cmd 打开终端
      2. 输入 java -version
      3. 如果看到类似下面的输出，说明安装成功：
        bash
        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)

  2. Linux：

    bash
    # 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. 安装构建工具 ​

  1. 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. 验证安装：
        bash
        mvn -version

    • Linux：

      bash
      # Ubuntu/Debian系统
sudo apt install maven

# CentOS 系统
sudo yum install maven

# 验证安装
mvn -version

  2. 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. 验证安装：
        bash
        gradle -version

    • Linux：

      bash
      # 使用 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. 进入项目目录 ​

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

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

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

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

2. 清理旧文件 ​

bash
mvn clean

这个命令会：

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

3. 打包项目 ​

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

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

在打包过程中你会看到：

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

4. 找到构建结果 ​

bash
# Windows
dir target
# 或
explorer target

# Linux/macOS
ls -l target

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

Gradle 构建步骤 ​

1. 使用 Gradle Wrapper（推荐） ​

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

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

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

2. 使用全局 Gradle ​

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

bash
gradle clean build

3. 找到构建结果 ​

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

# Linux/macOS
ls -l build/libs

常见问题解决 ​

1. 依赖下载失败 ​

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

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

  2. 手动下载依赖：

    bash
    # 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 错误：

  1. Maven 项目：

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

# Linux/macOS
export MAVEN_OPTS="-Xmx512m"

  2. Gradle 项目：

    bash
    # Windows
set GRADLE_OPTS=-Xmx512m

# Linux/macOS
export GRADLE_OPTS="-Xmx512m"

3. 编码问题 ​

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

  1. Maven 项目：

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

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

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

4. 其他常见错误 ​

  1. 找不到 JAVA_HOME：

    • 检查环境变量是否正确设置
    • 重新打开终端让环境变量生效

  2. 找不到 mvn/gradle 命令：

    • 检查环境变量是否正确设置
    • 确认安装路径是否正确
    • 尝试重新安装构建工具

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

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

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