outputs.upToDateWhen { true } 并不跳过首次执行，而是参与Gradle综合的“最新性判断”流程——它仅声明输出文件状态有效，但任务是否真正跳过执行，还需结合输入变更、构建脚本修改、动作定义时机等多因素共同决定。
gradle任务的uptodatewhen机制并不意味着“任务永不执行”，而是作为输出层面的最新性断言参与整体评估。`outputs.uptodatewhen { true }` 仅表示“当前输出内容被视为逻辑上有效”，但gradle仍会执行完整的任务生命周期检查，包括输入文件变化、构建脚本变更、任务动作注册时间等。
在Gradle中，一个任务是否被跳过（即标记为 UP-TO-DATE），取决于输入（inputs）→ 执行（actions）→ 输出（outputs） 的全链路一致性校验。upToDateWhen 只是输出校验环节的一个可选钩子，而非最终开关。
✅ 正确理解 upToDateWhen
task inputOutputCheckWithMethodCall(group: 'Learn-Task-Execution',
description: 'Learn how Gradle determines task up-to-dateness') {
outputs.upToDateWhen { true } // 仅影响 outputs 的校验结果
doFirst {
println 'Executing task inputOutputCheckWithMethodCall'
}
}
该配置下：
- 首次执行必运行：因为Gradle检测到构建脚本（build.gradle）本身是该任务的隐式输入源，脚本内容变更（如新增/修改此task定义）会导致任务“out-of-date”；
- 第二次及后续执行可能跳过：若构建脚本未变、无其他输入变更、且outputs.upToDateWhen返回true，Gradle才判定输出有效，最终跳过执行并输出 UP-TO-DATE。
⚠️ 关键注意事项
- 构建脚本即输入：任何对build.gradle的编辑（哪怕只加个空格）都会使所有在其中定义的任务重新变为 OUT-OF-DATE；
- doFirst/doLast 注册时机影响判定：若动作在脚本执行时动态注册（如通过闭包或方法调用），Gradle会将脚本执行过程视为任务动作来源的一部分，进一步强化“输入变更”信号；
-
日志调试建议：使用 ./gradlew yourTask --info 查看详细判断依据，典型提示如：
Task ':yourTask' has additional actions that have changed 或
Task ':yourTask' is not up-to-date because the build script has changed。
✅ 替代方案：实现真正“永不执行”的任务
若目标是完全跳过执行（例如占位或条件禁用），应使用 enabled = false 或 onlyIf：
task alwaysSkipped {
enabled = false // 彻底禁用，不参与任何 up-to-date 检查
doLast { println "This will never print" }
}
task conditionallySkipped {
onlyIf { false } // 执行前强制跳过，不进入生命周期
doLast { println "Also never prints" }
}
总之，upToDateWhen 是Gradle增量构建体系中精细化控制输出有效性的重要工具，但绝非“执行开关”。掌握其与输入、脚本、动作注册的协同机制，才能写出真正高效、可预测的构建逻辑。
