从GitHub仓库构建.jar文件失败求助：环境变量等问题排查

一、修复unable to get mutable windows environment variable错误 #

这个错误大多和Windows权限、PowerShell执行策略或Gradle缓存有关，按以下步骤排查：

• 以管理员身份打开PowerShell，执行命令修改执行策略：

  Set-ExecutionPolicy RemoteSigned
  

  确认选择Y，允许本地脚本运行。
• 删除Gradle缓存：找到用户目录下的.gradle文件夹（路径示例：C:\Users\你的用户名\.gradle），直接删除，然后重新运行构建命令。
• 确保PowerShell当前路径是仓库根目录（包含gradlew.bat、src、build.gradle的文件夹），再执行：

  ./gradlew.bat build
  

二、让Eclipse正确识别项目 #

1.18.2版本的MC模组基于Gradle构建，不能直接导入普通项目：

• 打开Eclipse，选择File > Import > Gradle > Existing Gradle Project，选中仓库根目录，按照向导完成导入，Eclipse会自动下载依赖并配置项目。
• 如果导入后仍有异常，先在PowerShell中执行./gradlew.bat eclipse，生成Eclipse专属配置文件，再重新导入。

三、关于GitHub直接构建的说明 #

GitHub本身无法直接生成jar文件，需要通过GitHub Actions配置自动化构建，但对于新手来说，优先解决本地构建问题更高效，暂时无需折腾这个。

四、Java版本的正确配置 #

MC 1.18.2模组开发强制要求Java 17，无需切换Java 8，按以下步骤确认配置：

• 打开命令提示符，执行java -version和javac -version，确保输出均为17.x.x版本。
• 检查系统环境变量：确保JAVA_HOME指向C:\Program Files\Java\jdk-17，且Path中%JAVA_HOME%\bin的位置在所有其他Java路径之前，避免系统调用旧版本Java。

五、问题根源判断 #

目前该仓库1.18.2分支处于维护状态，若仓库Issues中无相同构建报错，大概率是本地环境配置/操作问题，而非仓库本身的问题。按照上述步骤逐一排查，基本能解决构建问题。

内容的提问来源于stack exchange，提问作者Ethonodon