Appearance
命令速查表
基础构建
| 命令 | 说明 |
|---|---|
./gradlew build | 完整构建（编译+测试+打包） |
./gradlew clean | 清理 build/ 目录 |
./gradlew clean build | 清理后重新构建 |
./gradlew assemble | 只打包（不运行测试） |
./gradlew check | 只验证（测试+代码检查） |
./gradlew build -x test | 构建时跳过测试 |
./gradlew build --continue | 遇错继续执行 |
运行应用
| 命令 | 说明 |
|---|---|
./gradlew run | 运行应用（application 插件） |
./gradlew run --args="--port 8080" | 传入命令行参数 |
./gradlew bootRun | 运行 Spring Boot 应用 |
./gradlew installDist | 安装发行版到 build/install/ |
测试
| 命令 | 说明 |
|---|---|
./gradlew test | 运行所有测试 |
./gradlew test --tests "*.UserTest" | 运行特定测试类 |
./gradlew test --tests "*.UserTest.testCreate" | 运行特定方法 |
./gradlew test --rerun | 强制重新运行测试 |
./gradlew test --fail-fast | 第一个失败后停止 |
依赖管理
| 命令 | 说明 |
|---|---|
./gradlew dependencies | 查看所有依赖树 |
./gradlew dependencies --configuration compileClasspath | 查看编译依赖 |
./gradlew dependencyInsight --dependency guava | 追踪特定依赖 |
./gradlew build --refresh-dependencies | 强制刷新依赖 |
./gradlew dependencies --write-locks | 生成/更新锁文件 |
查看信息
| 命令 | 说明 |
|---|---|
./gradlew tasks | 查看可用任务 |
./gradlew tasks --all | 查看所有任务（含内部） |
./gradlew help --task build | 查看任务帮助 |
./gradlew projects | 查看项目结构 |
./gradlew properties | 查看项目属性 |
./gradlew buildEnvironment | 查看构建环境 |
./gradlew javaToolchains | 查看可用 JDK |
./gradlew --version | 查看 Gradle 版本 |
发布
| 命令 | 说明 |
|---|---|
./gradlew publishToMavenLocal | 发布到本地 ~/.m2 |
./gradlew publish | 发布到配置的仓库 |
./gradlew bootJar | 构建 Spring Boot JAR |
./gradlew shadowJar | 构建 Fat JAR |
多项目
| 命令 | 说明 |
|---|---|
./gradlew :core:build | 只构建 core 子项目 |
./gradlew :web:test | 只测试 web 子项目 |
./gradlew build --parallel | 并行构建 |
Wrapper 管理
| 命令 | 说明 |
|---|---|
gradle wrapper | 生成 Wrapper |
gradle wrapper --gradle-version 8.5 | 生成指定版本 Wrapper |
./gradlew wrapper --gradle-version 8.6 | 升级 Wrapper 版本 |
守护进程
| 命令 | 说明 |
|---|---|
./gradlew --status | 查看守护进程 |
./gradlew --stop | 停止所有守护进程 |
调试选项
| 选项 | 简写 | 说明 |
|---|---|---|
--info | -i | INFO 日志 |
--debug | -d | DEBUG 日志 |
--quiet | -q | 只显示错误 |
--stacktrace | -s | 显示堆栈 |
--dry-run | -m | 只列出任务，不执行 |
--scan | 生成构建扫描 | |
--profile | 生成性能报告 | |
--build-cache | 启用构建缓存 | |
--configuration-cache | 启用配置缓存 | |
--offline | 离线模式 | |
--no-daemon | 不使用守护进程 | |
--rerun-tasks | 强制重新执行所有任务 |
常用组合
bash
# 日常开发（快速构建）
./gradlew build -x test
# CI 构建（带缓存）
./gradlew build --build-cache --parallel
# 调试构建失败
./gradlew build --info --stacktrace
# 发布前验证
./gradlew clean test jacocoTestReport publish
# 更新所有依赖到最新
./gradlew dependencies --write-locks
# 性能分析
./gradlew build --profile --scan