最快方式是运行./gradlew -h查看帮助;./gradlew tasks列出所有可执行task(分组显示),加--all显示全部;./gradlew help --task <taskname>查具体task详情;./gradlew -v验证环境与Gradle版本。

直接运行 ./gradlew -h 或 ./gradlew --help 就能看到最简明的命令行帮助,这是最快、最可靠的方式。
查看所有可用任务列表
执行 ./gradlew tasks 会列出当前项目中所有可运行的 task,按分组(如 Build、Documentation、Verification)组织,带简短描述。它不显示隐藏任务,如果想看全部(包括被禁用或内部 task),加 --all 参数:./gradlew tasks --all。
- 常见遗漏:没加
./直接敲gradlew tasks(Linux/macOS 下会报 “command not found”) - Android 项目中,模块级 task 需要带路径,比如
./gradlew :app:assembleDebug,单独tasks只显示 root project 的 task - 输出过长时可配合
grep过滤,例如./gradlew tasks | grep test
查某个具体 task 的详细说明
用 ./gradlew help --task <taskname> 查指定 task 的类型、所属分组、是否可配置、支持哪些参数等。比如:
./gradlew help --task build ./gradlew help --task dependencies
这个命令比翻文档快得多,尤其当你不确定 assemble 和 build 差别时,一眼就能看到它们的依赖关系和描述。
- 注意拼写:task 名区分大小写,
test和Test是不同的(后者通常是类名,不是 task) - 缩写不通用:虽然
./gradlew bu有时能命中build,但./gradlew hel不一定触发help—— 依赖命名唯一性,不建议依赖缩写查帮助 - 部分插件注册的 task 可能不在默认
tasks列表里,但help --task仍能查到(只要它已注册)
快速确认 Gradle 版本与 Wrapper 状态
运行 ./gradlew -v 不仅显示 Gradle 版本,还会打印 JVM 信息、Kotlin/Gradle DSL 版本,并隐式验证 gradle/wrapper/gradle-wrapper.properties 是否有效。如果 wrapper 下载失败或版本不匹配,这里会第一时间报错。
- CI 环境下常忽略这点,结果在远程构建时报
Could not initialize class org.gradle.internal.jvm.JvmVersionDetector—— 很可能是 JVM 版本和 wrapper 声明的 Gradle 版本不兼容 -
-v输出里的Build time:是编译时间,不是你本地安装时间,可用来判断是否用了预期的 Gradle 版本 - 若提示
No such property: gradleVersion,说明gradle-wrapper.jar损坏或未生成,需重新运行./gradlew wrapper
真正容易卡住的地方,往往不是“怎么查帮助”,而是查完之后发现 task 名对不上、路径没写全、或者 wrapper 根本没生效——所以每次执行前,先 -v 看一眼环境,比反复试错快得多。


















