Gradle多项目构建：将某子项目设为所有子项目依赖遇问题

当然可行！Gradle本身就支持在根项目层面统一配置子项目依赖，完全不用在每个子项目的build.gradle里重复写compile project()（顺便提一句，compile已经是过时的配置了，现在推荐用implementation或api哦）。你之前尝试出错，大概率是配置的位置、语法或者细节没处理对，我来给你拆解正确做法和常见坑点：

一、最常用的统一配置方式：subprojects块 #

假设你的公共子项目名叫common，直接在根项目的build.gradle里添加以下配置：

subprojects {
    dependencies {
        // 用implementation替代过时的compile，api则用于需要依赖传递的场景
        implementation project(':common')
    }
}

注意：避免公共子项目自依赖 #

上面的配置会对所有子项目生效，包括common自己——这显然没必要，甚至可能引发奇怪的问题。可以加个判断排除它：

subprojects { subproj ->
    if (subproj.name != 'common') {
        dependencies {
            implementation project(':common')
        }
    }
}

二、你可能踩过的坑点 #

1. 依赖路径错误：要确保settings.gradle里已经正确声明了所有子项目，比如：

   include ':common', ':service-a', ':service-b'
   

   如果子项目在嵌套目录里，路径要写成:module:common这种格式，不能写错。

2. 使用了过时的依赖配置：compile在Gradle 7+已经被废弃，强制使用会触发警告甚至错误，替换成implementation（常规场景）或api（需要让依赖传递给上层项目时）。

3. 配置块放错位置：subprojects块必须放在根项目的build.gradle里，要是不小心写到某个子项目的配置文件里，肯定不会生效。

4. 循环依赖问题：如果common项目本身又依赖了其他子项目（比如service-a），就会形成循环依赖，Gradle会直接抛出错误。这种情况得调整你的项目结构，确保依赖链是单向的。

三、进阶：给特定子项目组配置依赖 #

如果不想给所有子项目都加common依赖，只想给某一组子项目配置，可以先在settings.gradle里给子项目分组：

// settings.gradle
include ':common'
include ':service-a'
include ':service-b'
include ':tool-c'

// 给服务类子项目打标签
project(':service-a').group = 'business-services'
project(':service-b').group = 'business-services'

然后在根项目的build.gradle里针对分组配置：

subprojects { subproj ->
    if (subproj.group == 'business-services') {
        dependencies {
            implementation project(':common')
        }
    }
}

总结一下：你的思路完全没问题，核心就是利用Gradle的根项目配置块统一管理依赖，减少重复代码。对照上面的坑点排查一下，应该就能解决之前的错误啦。

内容的提问来源于stack exchange，提问作者Hoof