直接在项目根目录运行gradle wrapper --gradle-version 8.7即可生成gradlew、gradlew.bat、gradle-wrapper.jar和gradle-wrapper.properties四个必需文件，需检查distributionUrl是否正确且提交这四个文件，后续构建必须使用./gradlew或gradlew.bat。
已有项目没 gradlew，怎么加？
直接在项目根目录运行 gradle wrapper 即可生成全部 Wrapper 文件。前提是本地已安装 Gradle（任意可用版本），且能执行该命令。它不会修改你项目的构建逻辑，只新增脚本和配置。
gradle wrapper 命令参数怎么选？
不带参数会用当前本地 Gradle 版本生成 Wrapper；但生产项目强烈建议显式指定版本，避免因本地环境差异导致生成的 Wrapper 不一致：
-
gradle wrapper --gradle-version 8.7：生成 8.7 版本的 Wrapper（推荐） -
gradle wrapper --gradle-version 8.7 --distribution-type all：下载含源码和文档的完整包（调试/离线查阅更方便） - 别用
bin类型——Android 项目依赖 Gradle 的 Groovy/Kotlin DSL 支持，all更稳妥
生成后必须改 gradle-wrapper.properties 吗？
不需要改，但必须检查。生成后打开 gradle/wrapper/gradle-wrapper.properties，确认 distributionUrl 指向的是你期望的版本，比如：
distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-all.zip
常见错误：
- URL 中漏掉
\转义冒号（https\://不是https://），否则运行./gradlew会报Invalid URL - 版本与 Android Gradle Plugin（AGP）不兼容，例如 AGP 8.4 要求 Gradle ≥ 8.6 —— 查官方兼容性表格比猜更可靠
哪些文件要提交到 Git？
只提交这四个：
gradlewgradlew.batgradle/wrapper/gradle-wrapper.jargradle/wrapper/gradle-wrapper.properties
其他 gradle/ 下的文件（如 init.gradle）、.gradle/ 目录、build/ 目录一律忽略。漏提 gradlew.bat 会导致 Windows 同事无法运行；多提了 .gradle/ 会污染仓库且每次变更巨大。
最易被忽略的一点：生成 Wrapper 后，所有构建命令都得换成 ./gradlew（macOS/Linux）或 gradlew.bat（Windows）——继续用 gradle 命令就绕过了 Wrapper，等于白配。
