常用命令

掌握 Gradle 的常用命令是日常开发的基础。以下命令均使用 ./gradlew（推荐），也可以用全局安装的 gradle。

基础构建命令

# 完整构建（编译 + 测试 + 打包）
./gradlew build

# 清理构建输出（删除 build/ 目录）
./gradlew clean

# 清理后重新构建（常用于解决奇怪的构建问题）
./gradlew clean build

# 仅编译主代码（不运行测试）
./gradlew compileJava

# 仅编译测试代码
./gradlew compileTestJava

# 仅打包 JAR（不运行测试）
./gradlew jar

# 运行应用程序（需要 application 插件）
./gradlew run

测试命令

# 运行所有测试
./gradlew test

# 运行特定测试类
./gradlew test --tests "com.example.UserServiceTest"

# 运行特定测试方法
./gradlew test --tests "com.example.UserServiceTest.testCreate"

# 使用通配符过滤测试
./gradlew test --tests "com.example.*Test"

# 强制重新运行所有测试（即使没有变更）
./gradlew test --rerun-tasks

# 测试失败后继续运行其他测试
./gradlew test --continue

跳过任务

# 构建时跳过测试（-x 或 --exclude-task）
./gradlew build -x test
./gradlew build --exclude-task test

# 跳过多个任务
./gradlew build -x test -x checkstyleMain

查看任务

# 查看主要任务（按分组显示）
./gradlew tasks

# 查看所有任务（包括内部任务）
./gradlew tasks --all

# 查看特定组的任务
./gradlew tasks --group build
./gradlew tasks --group verification

# 查看任务的帮助信息
./gradlew help --task build
./gradlew help --task compileJava

依赖管理命令

# 查看所有依赖树（包括传递依赖）
./gradlew dependencies

# 查看特定配置的依赖
./gradlew dependencies --configuration compileClasspath
./gradlew dependencies --configuration runtimeClasspath
./gradlew dependencies --configuration testCompileClasspath

# 查看某个依赖被哪些库引入（dependencyInsight）
./gradlew dependencyInsight --dependency spring-core
./gradlew dependencyInsight --dependency spring-core --configuration compileClasspath

# 多项目：查看子项目的依赖
./gradlew :core:dependencies

项目信息命令

# 查看项目基本信息（名称、描述、子项目）
./gradlew projects

# 查看项目属性
./gradlew properties

# 查看 Gradle 版本信息
./gradlew --version
gradle -v

调试与诊断

# 显示详细日志（info 级别）
./gradlew build --info

# 显示调试日志（debug 级别，非常详细）
./gradlew build --debug

# 显示警告信息
./gradlew build --warn

# 安静模式（只显示错误）
./gradlew build --quiet

# 构建扫描（上传到 scans.gradle.com 分析）
./gradlew build --scan

# Dry run：只显示会执行哪些任务，不实际执行
./gradlew build --dry-run

# 显示任务执行时间
./gradlew build --profile

性能优化命令

# 启用并行构建（多项目）
./gradlew build --parallel

# 启用构建缓存
./gradlew build --build-cache

# 启用配置缓存（Gradle 8+）
./gradlew build --configuration-cache

# 不使用守护进程（调试守护进程问题时）
./gradlew build --no-daemon

# 停止所有 Gradle 守护进程
./gradlew --stop

多项目命令

# 在所有子项目中执行 build
./gradlew build

# 只在 core 子项目中执行
./gradlew :core:build

# 只在 web 子项目中执行 test
./gradlew :web:test

# 查看 service:auth 的依赖
./gradlew :service:auth:dependencies

发布命令

# 发布到本地 Maven 仓库（~/.m2）
./gradlew publishToMavenLocal

# 发布到配置的远程仓库
./gradlew publish

# 安装到本地（旧 API，等同于 publishToMavenLocal）
./gradlew install

命令选项速查

选项	简写	说明
--info	-i	INFO 级别日志
--debug	-d	DEBUG 级别日志
--quiet	-q	只显示错误
--warn	-w	WARN 级别日志
--stacktrace	-s	显示完整堆栈
--full-stacktrace	-S	显示完整堆栈（含内部）
--exclude-task	-x	跳过指定任务
--continue		遇到错误继续执行
--parallel		并行执行子项目
--build-cache		启用构建缓存
--no-daemon		不使用守护进程
--rerun-tasks		强制重新执行所有任务
--dry-run	-m	列出任务但不执行
--scan		生成构建扫描报告
--offline		离线模式，只用本地缓存
--refresh-dependencies		刷新依赖（不使用缓存）

常用组合命令

# 日常开发：快速构建（跳过测试）
./gradlew build -x test

# CI 构建：带缓存的完整构建
./gradlew build --build-cache

# 解决依赖问题：查看冲突
./gradlew dependencyInsight --dependency log4j

# 调试构建失败：显示详细信息
./gradlew build --info --stacktrace

# 强制刷新所有依赖（网络问题后）
./gradlew build --refresh-dependencies

# 发布前完整验证
./gradlew clean test publish

下一步

• 构建生命周期 - 理解命令背后的执行过程
• 任务基础 - 学习如何自定义任务