3. 并行编译配置

3.1 原理：任务依赖图与并行执行模型

Gradle 默认按模块依赖顺序串行执行任务，但现代多核 CPU 并未被充分利用。并行编译通过将无依赖关系的任务分配到不同线程同时执行，大幅缩短构建耗时。核心原理基于 任务依赖图（Task Dependency Graph）：

• 每个模块（Project）对应一组任务（compileJava、processResources 等）。
• 模块间依赖构成有向无环图（DAG），只有入度为 0 的任务才能被调度执行。
• 并行执行时，Gradle 使用固定大小的线程池（默认 CPU 核心数）从 DAG 中同时取出多个就绪任务。

并行编译不改变模块依赖顺序，只允许可并行的任务同时运行。若模块 A 依赖模块 B，则 B 的编译任务必须先于 A 完成——这是依赖优先级的硬约束。

3.2 实现流程：三步开启并行编译

1. 在 gradle.properties 中启用全局并行
   添加以下配置：
   

   org.gradle.parallel=true

2. 调整最大工作线程数（max-workers）
   默认值为 CPU 核心数。对于 I/O 密集型项目（如大量资源拷贝）可适当增加；对于 CPU 密集型编译应保持在核心数附近。配置方式：
   

   org.gradle.workers.max=4
   # 或通过命令行临时覆盖：./gradlew build --max-workers=4

3. 验证模块间依赖关系
   并行效果取决于依赖图的“宽度”。若所有模块串行依赖（A→B→C→D），并行无法提速。使用以下命令分析依赖图：
   

   ./gradlew :app:dependencies --configuration compileClasspath

# gradle.properties
org.gradle.parallel=true
org.gradle.workers.max=4
org.gradle.caching=true
org.gradle.console=verbose

3.3 模块间依赖优先级：谁先谁后？

Gradle 并不提供显式设置优先级 API，但依赖关系天然定义了强制顺序。实际工程中常见的“隐式优先级”陷阱：

3.4 并行编译执行流程（SVG）

3.5 调试与验证

开启并行后，通过以下手段确认正确性：

• 查看构建日志：在 gradle.properties 中添加 org.gradle.console=verbose，观察输出中不同模块的任务是否交错出现。
• 使用 Build Scan（--scan）：可视化时间线，查看各模块开始/结束时间，确认无意外串行化。
• 线程 Dump：若怀疑死锁或线程饥饿，可在构建过程中执行 jstack <pid> 分析 Gradle Worker 线程状态。

# 串行（org.gradle.parallel=false）
Total build time: 142s

# 并行 + max-workers=6
Total build time: 51s (提速 64%)

# 并行 + max-workers=12（I/O 密集型资源拷贝）
Total build time: 47s (进一步提升 8%)

3.6 常见错误与解决方案

3.7 性能与稳定性优化建议

• 初始设置：保持 max-workers = 当前可用 CPU 核心数，运行一次完整构建后观察 CPU 利用率曲线。若平均利用率 < 70%，可逐步增加 1~2 个 worker。
• 依赖优先级显式化：仅在必要时使用 mustRunAfter，避免滥用导致并行度下降。
• 结合配置缓存：并行编译 + org.gradle.configuration-cache=true 能进一步减少配置阶段耗时。
• 内存调优：每个 worker 默认继承 Daemon JVM 参数。若总内存不足，可分离配置：
  

  org.gradle.jvmargs=-Xmx2048m -XX:MaxMetaspaceSize=512m
  # 注意：此内存由所有 worker 共享，需根据 worker 数预留

• CI 环境下注意：容器化构建中 CPU 配额可能被限制，Runtime.availableProcessors() 可能返回宿主机核心数而非容器允许值。建议通过环境变量显式覆盖：
  

  # 在 CI 脚本中
  export GRADLE_OPTS="-Dorg.gradle.workers.max=4"