如何在Gradle Kotlin DSL中实现依赖模块的兼容替换？

好问题！在Groovy DSL里做依赖模块替换确实顺手，换成Kotlin DSL其实核心逻辑完全一致，只是语法要贴合Kotlin的风格，我给你讲几个常用的场景和写法：

基础模块替换（远程库换远程库） #

假设你想把com.example:old-library替换成同组下更兼容的com.example:new-library，在Kotlin DSL里可以这么配置：

configurations.all {
    resolutionStrategy {
        eachDependency {
            if (requested.group == "com.example" && requested.name == "old-library") {
                // 沿用原依赖的版本号，也可以手动指定比如"2.0.0"
                useTarget("com.example:new-library:${requested.version}")
                // 可选：添加替换原因，方便团队协作时理解
                because("替换为官方推荐的兼容替代库")
            }
        }
    }
}

替换为本地项目模块 #

如果你正在调试一个本地模块，想把远程依赖换成本地项目里的模块（比如把com.example:shared-lib换成:shared-lib），用dependencySubstitution更直接：

configurations.all {
    resolutionStrategy {
        dependencySubstitution {
            substitute(module("com.example:shared-lib")) using project(":shared-lib")
        }
    }
}

这个场景在本地开发调试依赖项目时特别实用，不用反复发布快照版本。

按版本范围精准替换 #

要是你只想替换某个版本区间的依赖（比如把com.example:utils的1.x版本全部换成稳定的2.3.0），可以加版本判断：

configurations.all {
    resolutionStrategy {
        eachDependency {
            if (requested.group == "com.example" 
                && requested.name == "utils" 
                && requested.version?.startsWith("1.") == true) {
                useVersion("2.3.0")
                because("1.x版本存在性能问题，统一替换为优化后的2.3.0版本")
            }
        }
    }
}

总的来说，Kotlin DSL只是把Groovy里的动态写法换成了更严谨的Kotlin语法，核心都是通过resolutionStrategy来干预依赖解析逻辑，你可以根据自己的需求组合这些写法。

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