Android Studio中如何用内部模块替换外部RecyclerView依赖？

我明白你遇到的头疼问题：自定义了包名为androidx.recyclerview.widget的模块，但项目里其他外部库都依赖了官方RecyclerView库，导致类重复冲突。之前的Gradle配置没完全生效，是因为替换规则不够全面，下面给你一套更可靠的解决方案：

正确的Gradle依赖替换配置 #

在你的app模块的build.gradle（或者项目根目录的build.gradle，作用于所有模块）中，使用以下配置：

configurations.all {
    resolutionStrategy.dependencySubstitution {
        // 替换所有版本的官方RecyclerView依赖为你的自定义模块
        substitute module('androidx.recyclerview:recyclerview') using project(':recyclerview')
        // 兼容带版本号的依赖声明（比如某些库依赖特定版本）
        substitute module('androidx.recyclerview:recyclerview:+') using project(':recyclerview')
    }
}

为什么之前的配置无效？ #

你之前的配置同时用了force和substitute，而且只指定了1.1.0版本的替换，但项目中可能存在其他版本的官方RecyclerView依赖（比如某些库依赖1.0.0或1.2.0），这些未被覆盖的依赖依然会被引入，导致冲突。上面的配置会匹配所有版本的官方RecyclerView，统一替换为你的自定义模块。

验证替换是否生效 #

配置完成后，执行以下命令查看依赖树，确认所有官方RecyclerView依赖都被替换为你的模块：

./gradlew app:dependencies

在输出结果中搜索androidx.recyclerview:recyclerview，如果所有条目都显示project :recyclerview，说明替换成功。

额外注意事项 #

• 确保你的自定义模块recyclerview的包名确实是androidx.recyclerview.widget，这样替换后类的全限定名完全一致，不会出现类找不到的问题。
• 如果某些库直接内嵌了RecyclerView的类（而非通过Gradle依赖引入），这种情况需要手动排查并处理该库的依赖（比如排除内嵌类，或者替换该库版本）。

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