Java Gradle 项目 Wrapper 问题：‘...\wrapper\dists\gradle-7.1.1-all\gradle-7.1.1‘ does not exist.

问题与处理策略

问题描述

• 打开一个 Java Gradle 的项目，报如下错误

The specified Gradle installation directory '...\wrapper\dists\gradle-7.1.1-all\gradle-7.1.1' does not exist.

# 翻译

指定的 Gradle 安装目录：'...\wrapper\dists\gradle-7.1.1-all\gradle-7.1.1' 不存在

问题原因

1. 打开这个项目时，默认使用了本地安装的 Gradle 版本，而不是 Wrapper

2. 如果本地安装的 Gradle 版本与项目所需的版本不匹配，或者 Gradle 安装路径配置不正确，就会导致这个错误

处理策略

• 在 IDEA 中，修改 Gradle 配置的 Distribution 为 Wrapper

1. 打开 【File】 -> 【Settings】

2. 导航到 【Build, Execution, Deployment】 -> 【Build Tools】 -> 【Gradle】

3. 设置 【Distribution】 -> 【Wrapper】

• 为什么改用 Wrapper 可以解决问题

1. Wrapper 根据项目中的 gradle-wrapper.properties 文件指定的版本自动下载 Gradle

2. Wrapper 可以避免因本地 Gradle 版本不匹配导致的问题

3. Wrapper 自动管理 Gradle 的安装路径，不会依赖本地配置的 Gradle 路径，可以避免路径错误的问题