IntelliJ IDEA 2025.1 Help

Gradle 依赖项

IntelliJ IDEA 允许您在 Gradle 项目中添加和管理依赖项。 您可以添加依赖项并在图表中查看它们。

生成 Gradle 依赖

项目中添加的任何依赖项都是由 Gradle 管理的。 添加或管理依赖的最佳方式是在 build.gradle文件中。 您在 IntelliJ IDEA 模块设置 中手动配置的依赖项将在下一次 Gradle 项目 重新加载时被弃用。

添加 Gradle 依赖

  1. 在编辑器中打开 build.gradle 文件。

  2. Alt+Insert 打开 生成 上下文菜单。

  3. 从上下文菜单中选择 添加 Maven 工件依赖

    添加依赖

    Maven Artifact 搜索 窗口将会打开。

  4. Maven Artifact 搜索 窗口中,在搜索字段中,开始输入您的依赖项的名称。 在结果列表中选择您需要的并点击 添加

    搜索工件
  5. 重新加载您的项目。

    IntelliJ IDEA 添加一个依赖到 build.gradle 文件。

    构建脚本:添加了依赖项

    IntelliJ IDEA 还会将依赖项添加到 依赖项 节点的 Gradle 工具窗口,并添加到 外部库项目 工具窗口中。

    Gradle 工具窗口和 Project 工具窗口

    如果添加的依赖项有其自己的传递依赖项,IntelliJ IDEA 会在两个工具窗口中显示它们。 除了传递依赖外,IntelliJ IDEA 还在 Gradle 工具窗口中指示循环依赖。

    Gradle 工具窗口:循环依赖

    如果您添加 source set 的依赖配置,它也会显示在 Gradle 工具窗口中。

    源集依赖

以图表形式查看依赖关系

您可以使用图表格式处理 Gradle 依赖。 当您有一个大型项目并希望全面了解依赖项(包括传递依赖项)在项目内部的连接方式时,这可能会很有帮助。

  1. Gradle 工具窗口中,选择一个项目,在工具栏上,点击 显示依赖关系图标 或从上下文菜单中选择 显示依赖项 选项。

    显示依赖项选项

    您可以选择 显示依赖关系弹窗 (Ctrl+Alt+U) 选项以在单独的窗口中打开图表。 要关闭弹出窗口,请按 Escape

  2. 在图示窗口中,IntelliJ IDEA 显示所有项目依赖项,包括传递性依赖项。

    Gradle 依赖关系图

    当您在图中导航到依赖项时,IntelliJ IDEA 会显示其版本、组和制品 ID。

    显示依赖信息

请使用图表窗口 工具栏管理图表。 您可以更改图表的大小,将其导出到文件,仅查看您感兴趣的图表部分,等等。

更改可见性级别

您可以更改可见性级别,例如,查看具有特定范围(编译、测试等)的依赖项。

  1. 在图表窗口中,选择项目并点击 更改可见级别图标

  2. 从列表中选择您要查看的依赖范围。 IntelliJ IDEA 仅显示指定的依赖范围。

    更改可见性级别

显示从选定项到根的路径

您可以选择依赖项并查看它们如何连接到根。

  1. 在图表窗口中,选择您想要查看与项目连接的依赖项。 如果您要一次选择多个依赖项,请按住 Shift 并进行选择。

  2. 在工具栏上,点击 “显示路径根选择”图标

显示路径根选择

显示所选节点的相邻节点

您可以选择依赖项并查看与所选节点连接的其他依赖项。 如果您有一个较大的图表并且只想专注于其中的一部分,这可能会有所帮助。

  1. 在图表窗口中,选择您需要的依赖项。 如果您要一次选择多个依赖项,请按住 Shift 并进行选择。

  2. 在工具栏上,点击 显示选定节点的邻居

显示所选节点的邻居

.

在图中搜索特定的依赖项

  1. 在图表窗口中,按 Ctrl+F 打开 图表元素 弹出窗口。

    搜索依赖
  2. 开始输入您想要查找的依赖项名称,从搜索结果列表中选择所需的依赖项并按下 Enter。 IntelliJ IDEA 在图中定位所需的依赖项。

    发现依赖

查看图表结构

  1. 生成图表。

  2. 请点击 结构 在左侧工具栏。 IntelliJ IDEA 会打开 结构 工具窗口,该窗口显示您的图表的地图,以及所选块及其邻居的预览。

    结构视图

    使用上下文菜单放大和缩小,移动画布,改变布局,并将图表的一部分导出为图像。

    上下文菜单

依赖分析器

Gradle 依赖分析器让您能够快速查看和分析已解析的依赖项、未解析的依赖项、有冲突的依赖项以及项目和子项目中的传递依赖项。

分析依赖性

  1. Gradle 工具窗口的工具栏中,点击 分析依赖性

    或者,在 Gradle 工具窗口中,右键点击所需的依赖项,然后从上下文菜单中选择 分析依赖关系。 您也可以右键点击 项目 视图中的模块并使用相同的操作。

    已解决的依赖项
  2. 依赖关系分析器 窗口中,您可以缩小分析范围,只检查冲突依赖项或检查用法。

    如果您想在 build.gradle 文件中查看所需的依赖项,请右键点击 用法 部分中的依赖项,然后选择 请前往 Gradle Dependency。 如果您点击 打开 Gradle 配置 项目节点,IntelliJ IDEA 将打开 build.gradle 文件。

    如果发现重复依赖项,它将被灰显。

    有关 依赖关系分析器 窗口中可用选项和图标的更多信息,请参阅 参考部分。

依赖性分析器工具窗口参考

条目

描述

范围

您可以看到项目中使用每个 dependency 的范围。 要根据其 scope缩小依赖项列表的范围,请从作用域列表中选择适当的选项。

依赖分析器:依赖范围

仅显示冲突

点击 冲突图标 仅查看未解决或有冲突的依赖项。

冲突的依赖项

显示 GroupId

点击 显示 GroupId 并选择 显示 GroupId 在依赖项列表中显示 GroupId

显示为树

切换 显示为树 以节点或平面列表的形式显示依赖项列表。

树视图将帮助您快速检查传递依赖项。

展开 / 折叠

使用 展开全部图标/折叠全部图标 展开或折叠依赖项列表。

最后修改日期: 2025年 4月 24日