Gradle 查看完整依赖树无需插件,直接用 :app:dependencies 和 dependencyInsight 任务;加 --configuration runtimeClasspath 可聚焦运行时依赖,dependencyInsight 能精准定位冲突来源。

Gradle 查看完整依赖树不需要额外插件——dependencies 和 dependencyInsight 是 Gradle 自带任务,开箱即用。
直接运行 :app:dependencies 查模块级依赖树
这是最常用、最直接的方式。默认输出包含所有配置(implementation、api、testImplementation 等)的依赖,信息量大但容易淹没重点:
-
./gradlew :app:dependencies—— 输出 app 模块全部配置的依赖树(含编译期、测试期等) - 如果项目有多个模块(如
:feature_login),把:app替换为对应路径即可 - 冒号
:是 Gradle 路径分隔符,:app表示从根项目开始的相对路径,不是随意加的 - 输出中每个缩进层级代表一层传递依赖,箭头
->表示版本被替换(如 A→B 表示 A 被 B 覆盖)
加 --configuration runtimeClasspath 聚焦实际打包依赖
Android 构建时真正打进 APK 的,是 runtimeClasspath 配置下的依赖。这个参数能过滤掉 compileOnly、annotationProcessor 等不参与运行时的依赖,让输出更干净、更贴近真实场景:
./gradlew :app:dependencies --configuration runtimeClasspath- 对 Kotlin Multiplatform 或 Java 项目,可换成
runtimeOnly或runtimeClasspath,具体取决于构建目标 - Android Studio 里同步后报
Duplicate class,优先用这个命令查,比全量输出快得多 - 注意:不同 Gradle 版本中该配置名可能略有差异(如旧版用
androidRuntime),但runtimeClasspath在 7.0+ 已稳定
用 dependencyInsight 定位具体库的冲突来源
当发现某个库(比如 com.google.guava:guava)有两个版本共存,或者某类找不到时,dependencyInsight 比手动搜索依赖树高效得多:
./gradlew :app:dependencyInsight --dependency com.google.guava:guava --configuration runtimeClasspath- 输出会列出所有引用路径、各版本仲裁结果,并标出哪个被选中(
(*))、哪个被丢弃(→) - 如果提示 “No dependencies matching…”,说明该库根本没被解析进来,可能是被
exclude掉了,或所在配置未启用传递依赖 - 不加
--configuration参数会默认查compileClasspath,容易误判运行时行为
导出到文件或用 Build Scan 做可视化分析
命令行输出一屏刷完就没了,大型项目里靠肉眼翻找效率极低:
- 导出文本:
./gradlew :app:dependencies --configuration runtimeClasspath > deps.txt,之后用编辑器搜索关键词 - 生成交互式报告:
./gradlew build --scan,按提示输入yes,访问生成链接,在 Dependency Verification 页面点冲突项就能展开完整引用链 - Android Studio 内部查看:右键
app模块 → Open Module Settings → Dependencies 标签页,但只显示直接声明的依赖,看不到传递路径 - 真正图形化依赖图需在 Gradle 工具窗口右键项目 → Show Dependencies,不过它不支持筛选配置,且对深层嵌套渲染有限制
最容易被忽略的是配置(Configuration)语义差异:同一份依赖在 implementation 和 runtimeClasspath 下的解析结果可能完全不同;而 dependencyInsight 不指定 --configuration 就容易查错上下文。别只盯着“有没有”,更要确认“在哪种配置下有没有”。











