如何强制IDEA使用指定Gradle版本？含单项目配置方法

核心排查前提 #

确保项目根目录下gradle/wrapper/gradle-wrapper.properties文件中的distributionUrl参数已配置为你需要的目标版本，示例如下（对应6.3版本）：

distributionUrl=https\://services.gradle.org/distributions/gradle-6.3-bin.zip

你当前本地无全局Gradle安装的配置是合理的，项目内执行Gradle命令直接使用对应Wrapper脚本即可：

• Mac/Linux系统使用 ./gradlew <命令>
• Windows系统使用 gradlew.bat <命令>
  你本地执行gradle返回如下结果属于正常情况：

% gradle
zsh: command not found: gradle

1. 强制IDEA全局默认使用指定Gradle版本（新导入/创建的项目默认生效） #

操作步骤：

• 打开IDEA全局默认设置：路径为 File > New Projects Setup > Settings for New Projects （旧版本IDEA路径为 File > Other Settings > Default Settings）
• 左侧菜单选择 Build, Execution, Deployment > Build Tools > Gradle
• 找到「Use Gradle from」配置项，选择 gradle-wrapper.properties 选项即可强制所有新项目默认使用Wrapper内定义的版本；如果需要固定使用某个本地存放的Gradle版本，选择Specified location后指定对应Gradle目录即可
• 点击「Apply」保存配置
  配置界面参考：
  

2. 强制已打开的现有项目使用指定Gradle版本 #

操作步骤：

• 打开当前项目的专属设置：路径为 File > Settings（Mac系统为 IntelliJ IDEA > Settings）
• 同样进入Build, Execution, Deployment > Build Tools > Gradle配置页
• 「Use Gradle from」选择gradle-wrapper.properties（或指定本地固定版本路径）
• 点击「Apply」保存后，右键点击项目根目录选择Reload Gradle Project即可立即生效

异常情况处理 #

如果配置完成后IDEA仍自动切换Gradle版本，排查是否安装了会修改构建配置的第三方插件，卸载异常插件后重试即可。

内容的提问来源于stack exchange，提问作者Paul Verest on LinkedIn