直接运行 ./gradlew build --scan 即可生成交互式 Build Scan 报告，自动分析构建全过程，精准定位性能瓶颈（如慢任务、缓存未命中、高配置耗时）和依赖冲突（多版本共存及路径），并提供修复建议；推荐通过 settings.gradle 或 gradle.properties 全局启用以常态化使用。

直接用 ./gradlew build --scan 就能生成 Build Scan 报告，它会自动分析构建全过程，精准指出性能卡点和依赖冲突位置，不用手动挖日志或猜原因。

快速生成扫描报告

最简单的方式是加一个参数：

• 运行 ./gradlew build --scan（或替换成你实际的任务，比如 assembleDebug）
• 构建完成后，终端会输出一个带有效期的唯一链接（如 https://scans.gradle.com/s/abcd1234）
• 打开链接，就能看到交互式可视化报告，无需额外部署

定位性能瓶颈

进入报告后，重点看 “Performance” 标签页：

JavaStoryDevelop

你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在

下载

• “Task Execution” 图表按耗时排序列出所有任务，一眼看出哪个最慢（比如 test 或 compileJava）
• 点击具体任务，可查看是否命中缓存（FROM-CACHE）、是否重复执行（EXECUTED），判断增量构建是否生效
• “Configuration Time” 显示配置阶段总耗时，若过高，说明 build.gradle 中存在大量动态逻辑或插件滥用

识别依赖冲突

切换到 “Dependencies” 标签页：

立即学习“Java免费学习笔记（深入）”；

• 搜索关键库名（如 guava 或 okhttp），报告会高亮显示多个版本共存的情况
• 点击冲突项，能看到每个版本来自哪个模块、哪条依赖路径（例如 app → lib-a → guava:28.0 vs app → lib-b → guava:31.1）
• 报告还会建议修复方式，比如用 resolutionStrategy { force '...' } 或 exclude

让扫描常态化

避免每次都要手动加参数，推荐在团队中统一启用：

• 在 settings.gradle 里添加：
  gradle.startParameter.buildScan = true
• 或在 gradle.properties 中设：
  org.gradle.configuration-cache=true（配合扫描效果更佳）
• CI 环境下还可结合 --info 输出更多上下文：
  ./gradlew build --scan --info