Gradle多模块库项目CPD插件警告的通用消除方案咨询

为什么单独构建模块会触发其他模块的CPD警告？ #

Gradle的配置阶段特性导致的：当你执行某个模块的任务时，Gradle会先解析整个项目的构建脚本（包括根项目和所有子模块），来确定任务依赖关系和执行计划。CPD插件在配置阶段会扫描所有模块的CPD配置，一旦发现不同模块的配置存在差异（比如一个模块通过约定插件开启了CPD检查，另一个没有），就会抛出配置不一致的警告——不管你实际构建的是哪个模块，只要配置阶段扫到差异就会触发。

无需逐个模块配置的通用方案 #

方案1：自动按条件应用约定插件 #

在根项目的build.gradle中，通过条件判断自动给目标模块应用约定插件，不用逐个模块手动配置：

subprojects {
    // 示例：仅给:location模块应用约定插件
    if (project.path == ':location') {
        apply plugin: 'your.code-quality-convention' // 替换为你的约定插件ID
    }

    // 更灵活的方式：给需要应用的模块添加属性
    // 比如在:location的gradle.properties中加applyCodeQuality=true
    // if (hasProperty('applyCodeQuality') && applyCodeQuality.toBoolean()) {
    //     apply plugin: 'your.code-quality-convention'
    // }
}

方案2：统一所有模块的CPD基础配置 #

如果不想给所有模块应用完整的约定插件，可在根项目中给所有子模块添加统一的CPD基础配置，消除配置差异：

subprojects {
    // 仅给Java模块配置（适配库项目场景）
    plugins.withType(JavaBasePlugin) {
        cpdCheck {
            // 和约定插件中的CPD基础配置保持一致
            toolVersion = '6.54.0'
            ignoreFailures = false
            source = sourceSets.main.java
            // 其他通用配置，比如排除文件
            exclude '**/generated/**'
        }
    }
}

之后约定插件可以在这个基础上，给目标模块添加更细化的配置（比如自定义规则集、增加检查范围等），这样所有模块的CPD配置基础一致，就不会出现跨模块警告。

关于关闭警告的合理性 #

• 可以关闭警告：你可以在根项目的gradle.properties中添加org.gradle.warning.mode=none来关闭所有警告，但这会屏蔽所有Gradle警告，包括有用的配置提示，不推荐。也可以通过日志过滤单独屏蔽CPD的警告，但Gradle没有直接针对单个插件警告的精准过滤方式，实现成本高。
• 合理做法：直接关闭警告是治标不治本的方式，配置差异会导致不同模块的代码检查规则不一致，破坏代码质量的统一性。更合理的是采用上面的通用方案，从根源消除配置差异，保证所有模块的代码检查规则对齐。

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