瀑布图初探：看懂构建的时空轨迹
打开构建扫描，第一眼看到的就是那个色彩斑斓的瀑布图。说实话，我第一次看到这玩意儿时也是一脸懵——一堆横条挤在一起，根本看不出门道。但别急，今天我就带你把它拆开来看。
这个图，说白了就是一张构建的“时间轴+资源消耗”的合影。每个条块都代表某个东西干了多久，谁先谁后，谁在等谁。咱们今天的目标很简单：识别时间线、阶段、任务和网络请求这四个基本要素。
从哪打开瀑布图？
在构建扫描页面上，找到 “Performance” 标签。点进去，默认展示的就是“Timeline”视图——这就是我们说的瀑布图。有些版本的Gradle Enterprise叫它“Build Time”视图，但本质一样。
构建扫描 → Performance → Timeline你可能会问：为什么不是其他选项卡？因为Timeline视图把所有事件按时间堆叠，一目了然。其他视图（如Task execution）更适合做细节排查。
--profile或者构建扫描没有收集到足够细粒度的数据。加上--scan重新跑一次就好。
时间线——最上面的那把尺
时间线是瀑布图的骨架。它从0开始，一直延伸到构建结束的总耗时。每个横条的长度就代表它占用的时间。
时间线上通常有刻度标记，比如每5秒一格。鼠标悬停时，会显示当前点的时间。利用这个，你能直接看出构建在哪个时刻发生了“断崖”——比如某个任务突然吃掉一大块时间。
阶段——构建的生命周期
你会看到一些灰色的背景区域，它们把整个时间线切割成几段。这些就是Gradle的构建阶段。我习惯把它们称作“幕布”——每个幕布背后是一类工作。
| 阶段名称 | 颜色/标识 | 说明 |
|---|---|---|
| Initialization | 浅灰色 | 读取settings.gradle，确定哪些项目参与构建 |
| Configuration | 浅灰色 | 解析所有build.gradle并构建任务图 |
| Task Execution | 彩色区域 | 真正的任务执行，每个彩色条都是一个Task |
| Finalization | 浅灰色 | 清理、缓存写入等收尾工作 |
嗯，这里要注意：Configuration阶段常常被低估。很多开发者以为配置阶段就是“读文件”，很快。但在多模块项目中，配置阶段可能吃掉总时间的30%以上。我遇到过最夸张的一个项目，配置阶段花了43秒——因为每个子模块都重复解析了巨大的Kotlin DSL脚本。
allprojects或subprojects配置。
任务——真正的“搬砖工”
在阶段内部，每一个彩色小横条就是一个Task。颜色代表不同的类型。官方默认的颜色映射大致这样：
- 蓝色：Java/Kotlin编译任务（如compileJava, compileKotlin）
- 绿色：测试执行任务（test, integrationTest）
- 橙色：资源处理（processResources, copy, jar）
- 红色：高耗时或失败的任务（通常需要关注）
- 紫色：代码检查（lint, checkstyle, detekt）
别忘了，每个任务条旁边还有一根细小的线——表示它依赖的前置任务。鼠标悬停在任务上，还能看到它的输出缓存状态：是FROM-CACHE还是EXECUTED。
我一般会按颜色扫描一遍：如果看到大片蓝色，说明编译是瓶颈；如果大片绿色，那测试密度过高了。你想想看，如果一个项目里有200个单元测试任务，每个只跑0.5秒，加起来就是100秒——这还只是顺序执行的结果。
网络请求——看不见的瓶颈
有时候你发现某个Task耗时很离谱，点开一看，里面全是网络I/O。这就是网络请求条目了。它们不会直接显示在瀑布图上，但如果你点开一个任务的详情，在“I/O”或“Network”子选项卡里就能看到。
网络请求分几种：
- 依赖下载：从Maven仓库拉JAR，通常是
Download类型 - 远程缓存查询：向HTTP缓存后端请求构建缓存
- 构建扫描上传：把结果发到Gradle Enterprise服务器
我曾经有个项目，构建从5分钟优化到1分钟，关键就是砍掉了多余的远程仓库查询。具体来说，我们在repositories里配了四个仓库，每个任务执行时都会按顺序去查——即使本地已经有了。用--refresh-dependencies只在需要时才刷新，瞬间省掉了3分钟。这就是瀑布图+网络请求面板组合分析的价值。
一张图捋清关系
下面这张SVG图，把今天讲到的四个核心元素以及它们之间的层级关系画了出来。你可以把它当作瀑布图的基础认知框架。
看懂这张图，你就掌握了瀑布图的骨架。从最上方的全局时间线，到灰色的阶段“幕布”，再到里面五彩斑斓的任务条，最后深入到任务内部揪出网络请求——这就是我们后续优化分析的基础路径。
快速上手清单
现在你可以打开自己的构建扫描，对照着做这几步：
- 先看时间线总时长，记住它。
- 识别出灰色的阶段区域，看看Configuration占了多少比例。
- 找到最长的几个彩色任务条（通常3-5个），记下它们的名字。
- 点击最长的那个任务，切换到“I/O”或“Network”面板，看是否有网络耗时。
- 把结果记录下来，下一章我们会教你怎么给这些瓶颈排序。