Gradle Wrapper文件被.gitignore误忽略导致新克隆项目构建失败；需检查并修正.gitignore中宽泛规则（如/gradle），改用gradle/*加!important/wrapper/，强制添加文件并清除Git缓存后提交。
Gradle Wrapper 文件被 Git 忽略后，gradlew、gradlew.bat 和 gradle/wrapper/ 下的文件不会进入仓库，新克隆项目的人会直接遇到 Task 'wrapper' not found 错误——这不是环境问题，是项目构建入口缺失。
检查 .gitignore 是否误删了 wrapper 目录
最常见的原因是项目初始化时用了 Android Studio 默认模板或全局 .gitignore，其中常含 /gradle 这一行。它会递归忽略整个 gradle/ 目录，连带把 gradle/wrapper/ 一起干掉。
- 运行
grep -r "gradle" .gitignore，确认是否有/gradle或gradle/这类宽泛规则 - 如果存在，把它改成更精确的写法：
gradle/!wrapper/（Git 不支持该语法），所以实际应改为排除子目录以外的内容，例如：gradle/*，再单独放行：!gradle/wrapper/ - 注意：Git 的
!pattern否定规则只对已匹配的上级规则生效，且必须按顺序书写，!gradle/wrapper/要写在gradle/*之后
恢复已忽略但本地仍存在的 wrapper 文件
如果 gradle/wrapper/ 在你本地还存在，只是没被提交，说明它曾被 git rm --cached 清过缓存，或一开始就没 add 过。
- 先确认文件是否真在磁盘上：
ls gradle/wrapper/gradle-wrapper.jar gradle/wrapper/gradle-wrapper.properties - 如果存在，执行：
git add -f gradle/wrapper/ gradlew gradlew.bat（-f强制添加，绕过.gitignore） - 如果不存在，得先生成：在项目根目录运行
gradle wrapper（需本地有 Gradle 环境），或用./gradlew wrapper（前提是已有可用 wrapper） - 生成后立即
git add，别等下次提交——否则又进不了仓库
修正后必须清除 Git 缓存并重加
改完 .gitignore 并补全文件，不清理缓存就 git add 是无效的。Git 仍认为这些路径“已被忽略”，即使规则已变。
- 运行
git rm -r --cached .（清空整个索引缓存，安全但耗时） - 或者更精准地只清相关路径：
git rm -r --cached gradle/wrapper/ gradlew gradlew.bat - 再执行
git add .，此时新.gitignore规则才真正生效 - 最后
git commit -m "restore gradle wrapper files"提交
最容易被跳过的其实是缓存清理这步——很多人改完 .gitignore 就直接 git add，发现还是不进暂存区，反复折腾却没意识到 Git 的索引里还锁着旧忽略状态。wrapper 文件一旦缺失，下游所有 clone 操作都会失败，修复动作必须落在代码仓库层面，而不是靠文档写“请手动下载”。
