Mac环境下编译Minecraft Mod执行gradle build失败求助
解决Gradle构建时Java 17工具链缺失问题
方案1:手动安装匹配架构的Java 17
打开终端,执行对应命令安装x86_64架构的OpenJDK 17:
- 若为Intel芯片Mac:
brew install openjdk@17 - 若为Apple Silicon芯片Mac(需适配x86_64架构):
arch -x86_64 brew install openjdk@17
- 若为Intel芯片Mac:
配置环境变量让Gradle识别该JDK:
- 执行命令将JDK路径加入环境变量(zsh终端):
echo 'export PATH="/usr/local/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc - 若为bash终端,替换为
~/.bash_profile:echo 'export PATH="/usr/local/opt/openjdk@17/bin:$PATH"' >> ~/.bash_profile - 刷新环境变量:
source ~/.zshrc
- 执行命令将JDK路径加入环境变量(zsh终端):
验证安装结果:执行
java -version,确认输出显示Java 17且架构为x86_64。回到项目目录,使用项目自带的Gradle Wrapper构建(避免全局Gradle版本不兼容):
./gradlew build
方案2:配置Gradle自动下载工具链
若不想手动安装JDK,可让Gradle自动匹配下载:
在项目根目录的
settings.gradle文件末尾添加仓库配置:pluginManagement { repositories { gradlePluginPortal() maven { url = "https://repo.gradle.org/gradle/libs-releases" } maven { url = "https://maven.adoptium.net/content/repositories/releases/" } } }在项目根目录的
build.gradle文件中确认工具链配置(无则添加):java { toolchain { languageVersion = JavaLanguageVersion.of(17) architecture = JvmArchitecture.X86_64 } }执行项目自带的Wrapper命令启动构建:
./gradlew build
关键注意事项
- 始终优先使用项目自带的
./gradlew命令,而非全局安装的gradle,项目的Gradle Wrapper已适配依赖版本,能规避多数兼容性问题。 - 可通过
uname -m命令确认Mac架构:输出x86_64为Intel芯片,arm64为Apple Silicon芯片,确保JDK架构与系统一致。
构建成功后,编译完成的.jar文件会存放在项目的build/libs目录下。
内容的提问来源于stack exchange,提问作者Partymaster_88
相关产品推荐
相关产品推荐

