gradle-wrapper.jar 文件丢失可直接补全，无需重装gradle或修改全局环境；常见原因包括.gitignore误配、克隆中断或解压遗漏，推荐用./gradlew wrapper命令自动生成匹配版本的jar及配套文件。
gradle-wrapper.jar 文件丢失，直接补上就行，不用重装 Gradle 或改全局环境。
检查 gradle/wrapper/ 目录是否真缺失 jar 文件
进入项目根目录，运行：
ls -l gradle/wrapper/
如果输出里没有 gradle-wrapper.jar，只有 gradle-wrapper.properties 或干脆空目录，就确认是 jar 缺失。常见原因包括：.gitignore 误配（比如写了 /gradle）、克隆时网络中断、或从压缩包解压遗漏。
- 别只看 IDE 是否报错，有些 IDE 会静默 fallback 到本地 Gradle，掩盖问题
- Android Studio 的 “Sync Project” 按钮失败，但终端执行
./gradlew --version也报找不到或无法加载主类 org.gradle.wrapper.GradleWrapperMain，基本可锁定 jar 缺失 - 注意 Windows 用户：
gradlew.bat依赖gradle-wrapper.jar，缺了它连 bat 脚本都起不来
用 ./gradlew wrapper 命令自动生成（推荐）
这是最干净的方式，能同时生成 gradlew、gradlew.bat、gradle-wrapper.jar 和 gradle-wrapper.properties 四个文件，且版本匹配当前项目需求。
- 确保项目根目录下没有
gradle/子目录（如有，先删掉整个gradle/目录） - 运行命令：
./gradlew wrapper --gradle-version 8.10 --distribution-type bin（版本按需替换，如项目要求 7.4，则写--gradle-version 7.4） - 执行后检查
gradle/wrapper/下是否出现gradle-wrapper.jar和gradle-wrapper.properties；./gradlew应能正常响应 - 不建议用
gradle wrapper（系统全局 gradle），因为可能跟项目期望的 Gradle 版本冲突
手动补 jar 文件要小心版本对齐
如果网络受限或无法执行 wrapper 命令，可从其他同版本项目拷贝 gradle-wrapper.jar，但必须核对 gradle-wrapper.properties 中的 distributionUrl。
- 打开
gradle-wrapper.properties，找到distributionUrl=...这一行，例如：distributionUrl=https\://services.gradle.org/distributions/gradle-8.10-bin.zip - jar 文件必须与该 URL 对应的 Gradle 版本完全一致；不同版本的
gradle-wrapper.jar不通用 - 不要从网上随便下载 jar 文件——它不是独立可运行的，而是跟 properties 里的 URL 绑定的“启动器描述符”
- 若 properties 文件也丢了，先按前一节方法用
./gradlew wrapper生成，再补 jar
真正容易被忽略的是：即使 gradle-wrapper.jar 补上了，如果 gradle-wrapper.properties 里的 distributionUrl 指向一个已下线或不可达的 Gradle 发行版链接，后续执行 ./gradlew build 仍会卡在下载环节。务必验证 URL 是否可用，必要时手动更新为当前有效的地址。
