# Gradle 工具窗口

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

> **TL;DR**
> 必需插件：   Gradle  （ [已安装](managing-plugins.html)默认启用）
>
>
>
> 访问：  `视图 | 工具窗口 | Gradle`

当您 [创建](gradle.html#gradle_create_project) 或 [打开](gradle.html#gradle_import_project_start) Gradle 项目时，Gradle 工具窗口会自动启用。 点击右侧边栏上的   Gradle   以打开工具窗口。 工具窗口显示了 Gradle 关联项目、其任务、依赖项以及对基础  `build.gradle` 文件所做的所有更改。

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

> **Note:**
> 如果您从侧边栏中移除了 Gradle 工具窗口，请从主菜单中选择  `视图 | 工具窗口 | Gradle`  重新打开它。

## Gradle

|  条目  |  快捷键  |  描述  |
| --- | --- | --- |
|  ![显示选项菜单](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moreVertical.svg)  |  |     点击此按钮可打开菜单，用于配置当前视图和更改工具窗口查看模式。 菜单项是可启用或禁用的选项。 活动项的名称左侧带有复选标记。       菜单中的可用选项如下：        * 分组模块 ：如果想在项目中对模块进行分组，请选择此选项。    * 群组任务 ：如果想对任务进行分组，请选择此选项。 例如，构建任务将包含在 build 目录中。    * 显示忽略 ：选择此选项以显示 [忽略的项目](work-with-gradle-projects.html#ignore_detach_gradle_project)。    * 显示工具栏 ：选择此选项以显示您的 Gradle 项目的工具栏。    * [查看模式](viewing-modes.html) ：固定停靠、未固定停靠、断开连接、浮动、窗口——这些选项允许您控制工具窗口的总体外观与行为。    * 分组选项卡 ：如果一个工具窗口中有多个视图可用，取消选择此选项可在单独的选项卡中查看这些视图。    * 移至 ：选择此选项以将 Gradle 工具窗口移动到顶部、左侧或右侧。    * 调整大小 ：选择此选项可调整 Gradle 工具窗口的大小。    |
|  ![隐藏工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.hide.svg)  |  `Shift+Escape` (Windows), `⇧ ⎋` (macOS), `⇧ ⎋` (IntelliJ IDEA Classic (macOS)), `⇧ ⎋` (macOS System Shortcuts), `Shift+Escape` (XWin), `Shift+Escape` (GNOME), `Shift+Escape` (KDE), `Shift+Escape` (Emacs), `Shift+Escape` (Sublime Text), `⇧ ⎋` (Sublime Text (macOS)), `Shift+Escape` (Visual Studio), `⇧ ⎋` (Visual Studio (macOS)), `Shift+Escape` (NetBeans), `Shift+Escape` (Eclipse), `⇧ ⎋` (Eclipse (macOS))  |     隐藏工具窗口 `Shift+Escape` (Windows), `⇧ ⎋` (macOS), `⇧ ⎋` (IntelliJ IDEA Classic (macOS)), `⇧ ⎋` (macOS System Shortcuts), `Shift+Escape` (XWin), `Shift+Escape` (GNOME), `Shift+Escape` (KDE), `Shift+Escape` (Emacs), `Shift+Escape` (Sublime Text), `⇧ ⎋` (Sublime Text (macOS)), `Shift+Escape` (Visual Studio), `⇧ ⎋` (Visual Studio (macOS)), `Shift+Escape` (NetBeans), `Shift+Escape` (Eclipse), `⇧ ⎋` (Eclipse (macOS))。       要隐藏所有工具窗口，请按 `Ctrl+Shift+F12` (Windows), `⌘ ⇧ F12` (macOS), `⌘ ⇧ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F12` (macOS System Shortcuts), `Ctrl+Shift+F12` (XWin), `Ctrl+Shift+F12` (GNOME), `Ctrl+Shift+F12` (KDE), `Ctrl+Shift+F12` (Emacs), `Ctrl+Shift+F12` (Sublime Text), `⌘ ⇧ F12` (Sublime Text (macOS)), `Ctrl+Shift+F12` (Visual Studio), `⌘ ⇧ F12` (Visual Studio (macOS)), `Ctrl+Shift+F12` (NetBeans), `Ctrl+Shift+F12` (Eclipse), `⌘ ⇧ F12` (Eclipse (macOS))。     |

## Gradle 任务

|  条目  |  描述  |
| --- | --- |
|  运行配置  |  此区域包含最后执行的任务列表以及这些任务执行时的命令类型。  |
|  任务  |  此区域包含所有可用任务的列表。  |
|  依赖项  |  此区域包含项目依赖项列表。  |

## 工具栏

|  条目  |  描述  |
| --- | --- |
|  ![重新导入所有 Gradle 项目](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.refresh.svg)  |  点击此按钮以在对 Gradle 脚本进行更改后重新导入所有已注册的 Gradle 项目。  |
|  ![关联 Gradle 项目](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.add.svg)  |  点击此按钮以 [链接](gradle.html#link_gradle_project)一个 Gradle 项目。  |
|  ![取消 Gradle 项目链接](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  点击此按钮以 [分离](work-with-gradle-projects.html#ignore_detach_gradle_project)外部 Gradle 项目。  |
|  ![下载源代码](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.download.svg)  |  点击此按钮以手动下载初始项目同步中未下载的项目依赖项源。 如果您希望始终为项目下载这些来源，请在   下载源代码  中使用 [构建工具。 Gradle](advanced-settings.html#build_tools_gradle)选项。  |
|  ![运行 Gradle 任务](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.consoleRun.svg)  |  请使用此按钮 [执行 Gradle 任务](work-with-gradle-tasks.html#gradle_tool_bar)。 当您点击此图标时，   运行任何内容   窗口将打开。 请输入您要执行的任务名称。 要执行多个任务，请输入任务名称，并使用 Space 分隔每个新任务。  |
|  ![全部展开](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)  |  使用这些按钮可展开或收起所有节点。  |
|  ![选择要导入的项目数据](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.moduleGroup.svg)  |  点击此按钮，通过 [导入项目数据](#Gradle_Project_Data_To_Import_dialog)对话框将模块或数据导入到您的 Gradle 项目中。 这对于多模块项目可能很有用。  |
|  ![切换离线模式](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.build.toggleOfflineMode.svg)  |  点击此按钮以在 [offline mode](working-offline.html#gradle)下处理 Gradle 项目。 在这种情况下，Gradle 将使用缓存中的依赖项。 Gradle 将不会尝试访问网络来执行依赖解析。 如果所需的依赖项不在缓存中，构建执行将失败。 此外，如果启用离线模式，则可能会导致项目的打开和同步失败。  |
|  ![分析依赖关系](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.build.dependencyAnalyzer.svg)  |  点击此图标以打开 [Dependency analyzer](work-with-gradle-dependency-diagram.html#dependency_analyzer)窗口。  |
|  ![显示图表](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.fileTypes.diagram.svg)  |  点击此图标以生成 [Gradle 依赖项](work-with-gradle-dependency-diagram.html)。  |
|  ![构建工具设置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)  |     使用此图标访问以下设置：        * 自动重载设置 ：选择此选项以在 [构建工具设置](settings-build-tools.html)对话框中配置 Gradle 项目的重新加载过程。    * Gradle 设置 ：选择此选项以在 [Gradle 设置](gradle-settings.html)对话框中配置当前 Gradle 项目的设置。    |

## 导入 Gradle 项目数据对话框

当您点击 ![选择要导入的项目数据](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.moduleGroup.svg) 工具栏上的   Gradle   工具窗口时，将出现此对话框。 使用此对话框将外部模块添加到项目中。 这可能对多模块项目有帮助。

|  条目  |  描述  |
| --- | --- |
|  请选择要包含在项目中的模块/数据  |  使用此区域查看当前项目可用的外部模块或数据列表。  |
|  ![全选](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.selectall.svg)  |  从列表中选择所有模块。  |
|  ![取消全选](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.unselectall.svg)  |  清除所选模块列表。  |
|  ![仅显示选定项](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.toggleVisibility.svg)  |  仅查看所选模块。  |
|  ![选择必需](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.codeInsight.intentionBulb.png) 选择必需项  |  如果您点击这个图标，IntelliJ IDEA 会在您不确定模块之间依赖关系的情况下选择适当的模块。  |

## 上下文菜单

|  条目  |  描述  |
| --- | --- |
|  ![打开 Gradle 配置](https://resources.jetbrains.com/help/img/idea/2026.3/gradle.icons.expui.gradle.svg)  |  选择此选项或使用快捷键打开  `build.gradle` 文件。  |
|  ![重新导入 Gradle 项目](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.refresh.svg)  |  选择此选项以 [重新导入](work-with-gradle-projects.html#gradle_refresh_project) 项目。  |
|  ![解除 Gradle 项目链接](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置](work-with-gradle-tasks.html#gradle_run_config)。  |
|  选择<task>  |  选择此命令以激活所选 Gradle 任务的配置。 如果所选任务没有现有的配置，该选项将被禁用并替换为   创建   选项。  |
|  同步前执行，同步后执行  |  选择这些命令可为所选任务设置相应标志。 在这种情况下，  Before Sync  和  After Sync  注释出现在节点名称旁边。  |
|  在构建之前执行，在构建之后执行  |  选择这些命令可为所选任务设置相应标志。 在这种情况下，将在节点名称旁显示  构建前  和  构建后  注释。  |
|  重建前执行，重建后执行  |  选择这些命令可为所选任务设置相应标志。 在这种情况下，将在节点名称旁显示  重新构建前  和  重新构建后  注释。  |
|  分配快捷键  |  选择此命令以 [将所选阶段与键盘快捷键关联起来](work-with-gradle-tasks.html#associate)。 在这种情况下，带有快捷方式的注释会出现在节点名称旁边。  |

## See also

### 开始

[工具窗口](tool-windows.html)

### 过程

[Gradle](gradle.html)

### 外部链接

[Gradle](http://gradle.org/)