# Gradle 依赖项

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 使用图表的必需插件：   图  。 该插件已捆绑并默认启用。
>
>
>
> 所需 Gradle 版本：4.5 及以上
>
>
>
> 添加 Gradle 依赖项所需的插件：   Kotlin  。 该插件已捆绑并默认启用。

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

## 生成 Gradle 依赖

项目中添加的任何依赖项都是由 Gradle 管理的。 添加或管理依赖的最佳方法是在  build.gradle.kts  文件中。 您在 IntelliJ IDEA [模块设置](creating-and-managing-modules.html) 中手动配置的依赖项将在下一次 Gradle 项目 [重新加载](work-with-gradle-projects.html#gradle_refresh_project)时被弃用。

Procedure: 添加 Gradle 依赖

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

2. 开始输入依赖的作用域或要添加的依赖名称。

IDE 会自动列出最相关的代码补全结果。 如果需要手动调用建议列表，请按 `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS))。 要展开建议列表，请再次按 `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS))。

> **Note:**
> 依赖配置列表由 Gradle 提供，并取决于  `plugins` 部分在  `build.gradle.kts` 中列出的插件。

3. [重新加载](work-with-gradle-projects.html#gradle_refresh_project)您的项目。

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

IntelliJ IDEA 还会在   依赖项   节点的   Gradle   工具窗口以及   外部库   的   项目   工具窗口中添加依赖。

![Gradle 工具窗口和 Project 工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_project_tool_window.png)

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

![Gradle 工具窗口：循环依赖](https://resources.jetbrains.com/help/img/idea/2026.3/cyclic_dependencies.png)

如果您添加 [source set](work-with-gradle-projects.html#gradle_source_sets) 的依赖配置，它也会显示在   Gradle   工具窗口中。

![源集依赖](https://resources.jetbrains.com/help/img/idea/2026.3/source_set_dependency.png)

## 以图表形式查看依赖关系

> **Warning:**
> 请确保已包含   图  。 另外，请确保您拥有 Gradle 版本 4.5.1 或更高版本。

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

Procedure:

1. 在   Gradle   工具窗口中，选择一个项目，在工具栏上，点击 ![显示依赖关系图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.fileTypes.diagram.svg) 或从上下文菜单中选择   显示依赖项   选项。

![显示依赖项选项](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_show_dependencies.png)

您可以选择   显示依赖关系弹窗  ( `Ctrl+Alt+U` (Windows), `⌘ ⌥ U` (macOS), `⌘ ⌥ U` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ U` (macOS System Shortcuts), `Ctrl+Alt+U` (XWin), `Ctrl+Alt+U` (GNOME), `Ctrl+Alt+U` (KDE), `Ctrl+Alt+U` (Emacs), `Ctrl+Alt+U` (Sublime Text), `⌘ ⌥ U` (Sublime Text (macOS)), `Ctrl+Alt+U` (Visual Studio), `⌘ ⌥ U` (Visual Studio (macOS)), `Ctrl+Alt+U` (NetBeans), `Ctrl+Alt+U` (Eclipse), `⌘ ⌥ U` (Eclipse (macOS))) 选项以在单独的窗口中打开图表。 要关闭弹出窗口，请按 `Escape` (Windows), `⎋` (macOS), `⎋` (IntelliJ IDEA Classic (macOS)), `⎋` (macOS System Shortcuts), `Escape` (XWin), `Escape` (GNOME), `Escape` (KDE), `Escape, Escape` (Emacs), `Escape` (Sublime Text), `⎋` (Sublime Text (macOS)), `Escape` (Visual Studio), `⎋` (Visual Studio (macOS)), `Escape` (NetBeans), `Escape` (Eclipse), `⎋` (Eclipse (macOS))。

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

![Gradle 依赖关系图](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_graph.png)

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

![显示依赖信息](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_show_dependency_info.png)

请使用图表窗口 [工具栏](diagram-toolbar-and-context-menu.html)管理图表。 您可以更改图表的大小，将其导出到文件，仅查看您感兴趣的图表部分，等等。

Procedure: 更改可见性级别

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

> **Tip:**
> 按住 `Alt` (Windows), `Alt` (macOS), `Alt` (IntelliJ IDEA Classic (macOS)), `Alt` (macOS System Shortcuts), `Alt` (XWin), `Alt` (GNOME), `Alt` (KDE), `Alt` (Emacs), `Alt` (Sublime Text), `Alt` (Sublime Text (macOS)), `Alt` (Visual Studio), `Alt` (Visual Studio (macOS)), `Alt` (NetBeans), `Alt` (Eclipse), `Alt` (Eclipse (macOS)) 并移动文本光标放大图表的部分。

> **Note:**
> 在 Android 和 Kotlin 项目中 IntelliJ IDEA 仅支持默认的可见性级别。

1. 在图表窗口中，选择项目并点击 ![更改可见级别图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.show.svg)。

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

![更改可见性级别](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_visibility_level.animated.gif)

Procedure: 显示从选定项到根的路径

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

1. 在图表窗口中，选择您想要查看与项目连接的依赖项。 如果想一次选择多个依赖项，请按住 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS)) 并进行选择。

2. 在工具栏中，点击 ![“显示路径根选择”图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.hierarchy.class.svg)。

![显示路径根选择](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_show_paths.animated.gif)

Procedure: 显示所选节点的相邻节点

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

1. 在图表窗口中，选择您需要的依赖项。 如果想一次选择多个依赖项，请按住 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS)) 并进行选择。

2. 在工具栏中，点击 ![显示选定节点的邻居](https://resources.jetbrains.com/help/img/idea/2026.3/app.graph.nodeSelectionMode_dark.svg)。

![显示所选节点的相邻节点](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_show_neighbors.animated.gif).

Procedure: 在图中搜索特定的依赖项

1. 在图表窗口中，按 `Ctrl+F` (Windows), `⌘ F` (macOS), `⌘ F` (IntelliJ IDEA Classic (macOS)), `⌘ F` (macOS System Shortcuts), `Ctrl+F` (XWin), `Ctrl+F` (GNOME), `Ctrl+F` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+F` (Sublime Text), `⌘ F` (Sublime Text (macOS)), `Ctrl+F` (Visual Studio), `⌘ F` (Visual Studio (macOS)), `Ctrl+F` (NetBeans), `Ctrl+F` (Eclipse), `Ctrl+F` (Eclipse (macOS)) 打开   图表元素   弹出窗口。

![搜索依赖](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_dependency_find.png)

2. 开始输入您想要查找的依赖项名称，从搜索结果列表中选择所需的依赖项并按下 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。 IntelliJ IDEA 在图中定位所需的依赖项。

![发现依赖](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_dependency_find_result.png)

Procedure: 查看图表结构

1. 生成图表。

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

![结构视图](https://resources.jetbrains.com/help/img/idea/2026.3/diagram_structure_gradle.png)

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

![上下文菜单](https://resources.jetbrains.com/help/img/idea/2026.3/context_menu_gradle.png)

## 依赖分析器

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

Procedure: 分析依赖性

1. 在   Gradle   工具窗口的工具栏中，点击 ![分析依赖性](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.dependencyAnalyzer.svg)。

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

![已解决的依赖项](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_resolved_dependencies.png)

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

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

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

有关   依赖关系分析器   窗口中可用选项和图标的更多信息，请参阅 [参考](#dependency_analyzer_tool_window)部分。

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

|  条目  |  描述  |
| --- | --- |
|  范围  |  您可以看到项目中使用每个 dependency 的范围。 要根据其 [scope](https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#dependency-scope)缩小依赖项列表的范围，请从作用域列表中选择适当的选项。   ![依赖分析器：依赖范围](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_dependency_scope.png)  |
|  仅显示冲突  |  点击 ![冲突图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.problemsEmpty.svg) 仅查看未解决或有冲突的依赖项。   ![冲突的依赖项](https://resources.jetbrains.com/help/img/idea/2026.3/gradle_conflict_dependencies.png)  |
|  显示 GroupId  |  点击 ![显示 GroupId](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.show.svg) 并选择   显示 GroupId   在依赖项列表中显示 [GroupId](https://maven.apache.org/guides/mini/guide-naming-conventions.html) 。  |
|  显示为树  |  切换 ![显示为树](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.showAsTree.svg)以节点或平面列表的形式显示依赖项列表。    树视图将帮助您快速检查传递依赖项。     |
|  展开 / 折叠  |  使用 ![展开全部图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.expandAll.svg) / ![折叠全部图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.collapseAll.svg) 展开或折叠依赖项列表。  |