gradle默认支持java增量编译，但需确保模块依赖边界清晰、自定义任务声明输入输出、配合构建缓存等，才能真正跳过未变动代码的重复编译。
Gradle 默认就支持 Java 增量编译，但要真正避免重复编译未变动代码，关键不是“开启开关”，而是确保项目配置和任务行为符合 Gradle 的增量判断逻辑。它不会凭空跳过编译，而是靠精准识别输入变化、输出有效性与依赖边界来决定是否执行。
确认增量编译已启用且生效
Java 插件（java-library 或 application）从 Gradle 4.10 起默认启用增量编译，无需额外配置。但需验证是否实际生效：
- 检查构建日志中是否有
Compiling X source files后跟Incremental compilation enabled提示 - 修改一个 Java 文件后再次执行
./gradlew compileJava，观察是否只编译该文件及其直连依赖类（而非整个模块） - 若始终全量编译，可能是 IDE（如 IntelliJ）未启用 Gradle 代理编译，或手动调用了
--no-build-cache等禁用缓存的参数
规范模块依赖声明，守住 API/implementation 边界
增量编译的精度高度依赖模块间依赖类型的语义准确性。Gradle 需据此判断“哪些变更会影响下游”：
Java JDK 25
下载
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
- 用
api声明对外暴露的公共 API（如接口、DTO），其源码变更会触发所有api依赖者的重新编译 - 用
implementation声明仅内部使用的依赖（如工具类、实现类），其变更不会传播到无关模块 - 避免滥用
compile（已废弃）或runtimeOnly替代编译期依赖，否则 Gradle 无法正确推导影响范围
让自定义任务也支持增量逻辑
如果项目中有自定义 Task（如代码生成、资源处理），它们默认不参与增量判断，容易成为重复构建瓶颈：
- 为 Task 显式声明输入与输出：用
@InputFiles、@InputDirectory标记源路径；用@OutputDirectory、@OutputFile标记产物路径 - 在
@TaskAction方法中接收IncrementalTaskInputs参数，只处理outOfDate和removed的文件 - 避免在 Task 中直接操作
File集合（如new File(...).listFiles()），改用FileCollection，否则 Gradle 无法追踪文件粒度变更
配合构建缓存进一步跳过已知结果
增量编译解决“本次构建内”的冗余，而构建缓存解决“跨次构建”的冗余——两者叠加效果更佳：
- 在
gradle.properties中启用本地缓存：org.gradle.caching=true - 对 CI 环境，建议接入远程构建缓存（如 Gradle Enterprise 或自建 HTTP 缓存服务）
- 注意：缓存命中前提包括 JDK 版本、Gradle 版本、任务输入哈希一致；避免在 Task 中引入非确定性输入（如当前时间、随机数）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
