素材阁

Gradle 命令速查

共 30 条 Gradle 常用命令,覆盖常用任务、Wrapper、依赖查看、常用开关、守护进程与 诊断、多模块项目六组场景。支持搜索与分类筛选,点击命令即可复制。

常用任务

任务名执行,可组合多个。

命令说明
列出可用任务
清理 build 目录
编译、测试并打包
打包但不运行测试
运行测试
运行应用(app 插件)
常用组合
运行校验任务(含测试、静态检查)

Wrapper

用项目自带的 gradlew 保证版本一致。

命令说明
用项目内的 wrapper 构建(Windows 为 gradlew.bat)
生成 / 更新 wrapper 到指定版本
查看 wrapper 使用的 Gradle 版本

依赖查看

排查依赖与版本冲突。

命令说明
打印完整依赖树
只看某模块某配置的依赖
追踪某依赖的来源与版本选择
强制刷新依赖

常用开关

提速、跳过与离线。

命令说明
排除 test 任务
离线构建
并行构建多模块
启用构建缓存复用任务结果
忽略 up-to-date 检查,强制重跑
输出更详细日志(--debug 更细)

守护进程与诊断

提升重复构建速度。

命令说明
查看 Gradle 守护进程状态
停止守护进程
不启用守护进程(CI 里常这么用)
启用配置缓存,进一步提速
生成构建扫描报告便于分析

多模块项目

从根目录操作子项目。

命令说明
只构建名为 app 的子项目
同时执行多个子项目任务
声明参与构建的子模块(include "app")
列出所有子项目

使用说明

Gradle 常用命令速查:常用任务、Wrapper、依赖查看、常用开关、守护进程与多模块;支持搜索与分类筛选,点击命令即可复制。

  1. 按用途点分类:常用任务、Wrapper、依赖查看、常用开关、守护进程与诊断、多模块项目。
  2. 点「命令」列复制,替换任务名与子项目名后执行。
  3. 团队协作统一用项目自带的 ./gradlew(Windows 用 gradlew.bat),避免各自 Gradle 版本不一致。
  4. 加速构建:开启 --parallel 与 --build-cache;CI 里常用 --no-daemon。

常见问题

gradle 和 gradlew 有什么区别?
gradle 用的是你系统里安装的 Gradle;gradlew 用的是项目内 wrapper 指定的版本。为保持一致,团队项目一律用 gradlew。
build 和 assemble 有什么区别?
assemble 只把产物打包出来;build 在 assemble 基础上还会运行 test 与 check 等校验任务。只想快速打包、跳过测试时用 assemble 或 -x test。
怎么排查依赖版本冲突?
用 gradle dependencies 看依赖树,用 gradle dependencyInsight --dependency <库名> 追踪某库最终选用了哪个版本及原因,再在 build.gradle 里锁定。
为什么第二次构建快很多?
Gradle 有增量构建、守护进程与构建缓存三套机制:任务输入未变就跳过(up-to-date),常驻进程省去启动开销,构建缓存还能跨机器复用结果。

延伸阅读

相关工具