--parallel 通过模块级并发加速多模块构建，但仅对无强依赖的子项目有效；单模块无效，需配合解耦、缓存等优化才能显著提速。

Gradle 的 --parallel 参数确实能显著缩短多模块项目的构建时间，但它的效果高度依赖项目结构和任务依赖关系，并非简单开启就一定“大幅缩短”。关键在于理解它如何工作、适用场景以及配合其他优化手段使用。

并行执行的本质：模块级并发，不是任务级乱序

--parallel 并不是让所有编译任务（如 javac）同时跑在多个线程上——那是 org.gradle.parallel（默认开启）或 JVM 编译器本身的并行能力决定的。它的核心是：**允许 Gradle 同时构建多个相互独立的子项目（subprojects）**。比如你有 api、service、web 三个模块，且它们之间没有 project(':api') 这样的强依赖，Gradle 就会把这三个模块的 compileJava、processResources 等生命周期任务分别调度，在不同线程中并行执行。

• 如果模块间存在强依赖（例如 service 依赖 api），Gradle 会自动串行化，--parallel 对这部分无效
• 单模块项目开启 --parallel 几乎无收益，因为没“多个模块”可并行
• 它不改变单个 compileJava 任务内部是否并行编译源文件——那是 forkOptions 或 JDK 的事

正确启用并行：命令行与配置双保险

推荐两种方式结合使用，避免遗漏：

Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。

下载

• 命令行临时开启：直接加参数 ./gradlew build --parallel --max-workers=4（--max-workers 建议设为 CPU 核心数，避免过度争抢资源）
• 全局配置（推荐）：在项目根目录 gradle.properties 中添加：
  org.gradle.parallel=true
  这样每次构建都默认启用，无需反复敲参数

真正提速的关键：解耦模块 + 配合其他优化

只靠 --parallel 往往不够，需组合以下实践：

• 减少跨模块强依赖：用 API/implementation 替代 compile（已废弃），明确依赖传递性；对非必要依赖，考虑用 runtimeOnly 或提取公共库
• 启用构建缓存：在 gradle.properties 加 org.gradle.configuration-cache=true（Gradle 7.4+）和 org.gradle.caching=true，复用历史构建结果
• 关闭冗余检查：开发阶段可临时禁用 check 类任务（如 ./gradlew build -x test -x check），聚焦编译本身
• 增量编译保障：确保 sourceSets 路径清晰，避免 src/main/java/**/* 和 src/main/resources/**/* 混淆导致全量重编

验证是否真正在并行：看日志和监控

不要凭感觉判断。构建时加 --info 或 --scan（生成 Build Scan）观察：

• 日志中出现类似 Executing task ':api:compileJava' in parallel with other tasks 表示生效
• Build Scan 页面的 “Timeline” 视图能直观看到多个模块任务是否横向铺开
• 若发现大量 Waiting for task ... to complete，说明模块依赖过紧，需重构

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南