优先用./gradlew wrapper重生成完整wrapper三件套;若gradlew不存在,则用系统gradle执行gradle wrapper --gradle-version x.x,并检查ide设置、.gitignore及离线模式。

gradle-wrapper.properties 文件不存在,直接补还是重生成?
直接手动创建 gradle-wrapper.properties 是最快的兜底方式,但仅适用于你清楚目标 Gradle 版本且项目不依赖特定 Wrapper 行为的场景。如果项目是 Android 或 Hippy 等跨端框架示例工程,建议优先用命令行重建——因为手动补全容易漏掉 gradle-wrapper.jar 和脚本权限,而 ./gradlew wrapper 会一次性生成全部三件套:gradlew、gradlew.bat、gradle/wrapper/ 目录及其两个核心文件。
用 ./gradlew wrapper 命令失败:提示 command not found?
这是最典型的“鸡生蛋”问题:没有 gradlew,就跑不了 wrapper 任务。此时必须切换到系统级 Gradle 执行:
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 确认本地已安装 Gradle(运行
gradle -v查看版本),且版本 ≥ 6.8(Android Gradle Plugin 7.0+ 要求) - 在项目根目录执行:
gradle wrapper --gradle-version 7.4.2 --distribution-type bin(注意不是./gradlew) - 执行后检查是否生成了
gradle/wrapper/gradle-wrapper.properties和gradle/wrapper/gradle-wrapper.jar;若没生成gradlew脚本,手动赋予可执行权限:chmod +x gradlew
Android Studio 同步仍报 Task 'wrapper' not found
即使文件都存在,IDE 也可能因缓存或配置误判导致识别失败。重点检查三处:
- 打开
File → Settings → Build, Execution, Deployment → Gradle,确认 “Use Gradle from” 选的是 “Wrapper configuration”,而非“Gradle installation path” - 检查项目根目录下是否存在
.gitignore,内容是否包含/gradle或gradle-wrapper*—— 这是开源项目(如 Hippy 示例)最常见的丢失原因 - 点击右上角 “Sync Project with Gradle Files” 前,先关闭 IDE 的 “Offline work” 模式(
File → Settings → Build → Gradle),否则distributionUrl指向的远程 ZIP 无法下载
gradle-wrapper.properties 里 distributionUrl 写错会怎样?
写错 URL 不会立即报错,但会在首次执行 ./gradlew build 时卡住或抛出 Connection refused / 404 Not Found。关键点:
- URL 必须以
https\://开头(反斜杠是必需转义),结尾推荐用-bin.zip(轻量,不含源码和文档),避免-all.zip导致下载超时 - 版本需与项目中声明的 Android Gradle Plugin(AGP)兼容,例如 AGP 8.2 要求 Gradle ≥ 8.2;查兼容表最稳妥的方式是翻
build.gradle里com.android.tools.build:gradle的版本号,再对照官方文档 - 国内访问
services.gradle.org不稳定,可临时替换为清华镜像:distributionUrl=https\://mirrors.tuna.tsinghua.edu.cn/gradle/gradle-7.4.2-bin.zip
gradle-wrapper.properties 和本地 gradle/wrapper/ 目录可能版本错位——这时光删文件再重跑 wrapper 任务还不够,得连同 .gradle/ 缓存目录一起清理,否则旧 jar 仍会被加载。










